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INTRODUCTION 


CHAPTER 1 

INTRODUCTION TO THE V/SCSI 4210 


Interphase wrote this manual for its customers, it is Intended for a higNy technical audience, specifically, 
users who need to write their own software drivers. 

Readers are assumed to have extensive knowledge of the following: 

• The C programming language, including experience writing and installing interface software (drivers). 

• The operating system of the host computer. 

• SCSI specifications. 

SCOPE OF MANUAL 

This manuals organization aiiows you to focus cxr your speciHc areas of interest, without gh/ing you more 
information than needed. 

Specifically, this manual contains guidelines on: 

• installing the V/SCSI 4210 Jaguar 

• Programming the V/SCSI 4210 Jaguar 

• Determining the cause of error messages which may be generated by the board. 

GENERAL MANUAL INFORMATION 

You will find it very useful to read this Introduction completely. It contains information that will clarify many 
of your questions later. The Conventions section can be especially useful for later reference since it defines 
how certain topics will be presented to you. 

Be sure to perform the installation of the product using the installation chapter. Read this chapter 
thorougNy before attempting the installation. 

Chapter 3 provides an overview of how the product's interface works. It gives procedures for submitting 
commands, as well as specific facts about SCSI that affect board operation. 

Interphase can supply you with an example driver, if your system only requires minor modifications of this 
driver, then the source code provided gives a good base from which to start. If your system is radically 
different, then the example driver at least gives you ideas on what must functionally be contained in a driver. 
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OVERVIEW 

The V/SCSI4210 tJaguar is a VMEbus SCSI host adapter capable of controliing up to 14 SCSI devices- 
seven with the primary SCSI port (Port 0). plus seven more if the optional secondary SCSI port (Port 1) 
is installed. As an alternative, the secondary port can be used to output data to a printer, provided your 
setup includes the optional printer port daughter card. 

SYSTEM INTERFACE 

The host processor communicates with the Jaguar through 2 Kbytes of onboard RAM. All 
commands and responses pass through this 2K space, which is referred to as "short I/O." 
because it is mapped into the short I/O space of the VMEbus. 

Each command to the Jaguar is specffied using a host-generated software structure called an 
Input/Output Parameter Block (lOPB). lOPBs can be bult in either the Jaguar's 2K short I/O 
space or offboard in system memory. In the latter case, command completions are posted to 
both on- and offboard data structures. 

The system-level Interface, referred to as "MACSI" (for Multiple Active Command Software 
interface), is implemented in short I/O. In addition to supporting command queuing, MACSI 
enables multiple commands to be active slmultarieousiy. The Jaguar accepts commands from 
the host and queues them internally. It then acts on each command as soon as possible, within 
the confines of the SCSI bus. As commands are completed, the host Is notified of each 
command's completion, as well as its completion status. 

ISSUING COMMANDS 

The host submits commands to the Jaguar by making an entry into a circular queue called the 
Command Queue. Each Command Queue e^ is a 12-byte block containing a pointer to the 
lOPB and other control information. 

lOPBs may be bult by the host either onboard On the Jaguar's Host Usable Space in short I/O), 
or offboard in system memory. Once It bulds an lOPB, the host creates an entry for the lOPB 
in the next avalable slot in the Command Queue. 

EXECUTING COMMANDS 

The Jaguar reads the Command Queue, determines which entry is to be executed next, and 
moves the appropriate Command Queue entry and lOPB into one of its internal work queues. 
The Jaguar supports up to 15 work queues, numbered 0 through 14. Work Queues 1 -14 are 
each intended to be dedicated to a specific SCSI device (or to a printer connected via the 
optional printer port daughter card). Thus, commands intended for a specific device are sent 
to the wt^ queue dedicated to that device. 

After the Command Queue entry and iOPB have been placed in a work queue, the slot in the 
Command Queue that was filed by the command becomes avalable for re-use by the host. As 
a result, the host virtually always has entries avalable in the Command Queue for issuing 
commands. This frees the host from the need to be concerned with any of the intimate timing 
issues of the Jaguar's Command Queue. 
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Even in the unlikely case that the Command Queue is full when the host tries to enter a 
command, the Jaguar provides efficient operation by optionally interrupting the host when an 
entry becomes available in the Command Queue. 

Once the command is moved into the appropriate work queue, the Jaguar executes it at the first 
opportunity. It then posts completion to the Command Response Block (located in either short 
I/O or in system memory) and generates an interrupt (if enabled to do so). The host 
acimowledges the interrupt by writing a word to the Commarxi Response Block, releasing it for 
further use. 

WORK QUEUES 

The concept of work queues is integral to the way theX MACS! allows muitipie commands to be 
active simultaneously. Information in the Command Queue entry determines the work queue into 
which a particular command is placed. At any time, there is an In Progress command for each 
work queue that has at least one entry. The Next command is simply waiting for the In Progress 
command from that work queue to complete. 

Since the SCSI bus allows many tasks to be overlapped on multiple devices, the MACSI interface 
allows for commands from all work queues to be interspersed. Assuming that the SCSI devices 
support overlapped activity on the SCSI bus (using Disc^nect/Reconnect), up to 14 commands 
(one in Progress command from each attached SCSI device) can be simultaneously active, 
resulting in overlapped data streams. Indeed, since the Jaguar has two fully independent SCSI 
buses, it can support two truly simultaneous data streams. If some devices do not support 
ovefiapped adivKy, they can be relegated to the second port, allowing fully functioning devices 
on the first port unrestricted operation. The second port can, of course, also support full SCSI 
functionality. 

The Jaguar accommodates up to 14 work queues, not counting a special queue called Work 
0. The host fixes each work queue's parameters when it initializes the queue. The host 
is then responsible for using the work queues in a manner consistent with the initialization 
scheme. The only restriction is that no more than one work queue can be allocated to a device. 
The number of entries in the Command Queue, the number of slots in each work queue, the 
characteristics of these queues, as well as other Jaguar operating parameters, are programmable 
and must be initialized before use. 

MASTER COMMAND ENTRY AND WORK QUEUE 0 

In order to initialize the board, as well as to execute very high priority commands, the Jaguar 
provides two auto-initiaiized fadities f the Master Command Entry arid Work Queue 0. 

The Master Command Entry is a 12-byte location in short I/O which has exactly the same form 
as a Command Queue entry (i.e. control information and a pointer to an lOPB). It acts like a 
single-entry Command Queue. Commands issued through the Master Command Entry are 
executed immediately. 

Likewise, the Work Queue 0 is a single-slot work queue capable of accepting one command at 
a time. It is highest priority work queue, so any command sent to Work Queue 0 is executed 
immediately, its len^ (one slot) cannot be changed by the host. 


1-3 






INTERPHASE CORPORATION 


Work Queue 0 is defined to have a iength of 1 so that oniy one error recovery process can 
occur at a tinie. However, it is possible that a command from Work Queue 0 may itself require 
error recovery. To deal with that situation, certain commands (spedficaily, SCSI Bus Reset and 
Rush Work Queue) may always be issued through Work Queue 0. For ail other commands. 
Work Queue 0 has a iength of 1. 

The Master Command Entry and Work Queue 0 aHow you to issue a single command and then 
wait for its completion bef^ issuing the next one. A typical use for these facilities is, upon 
power-up, to initialize the rest of the queues and start off normal SCSI operations. 

Note that the Master Command Entry and Work Queue 0 are not removed, even after the 
Command Queue and the other work queues are initialized and normal activity has begun. 

SUMMARY OF KEY FEATURES 

SCSI CONSIDERATIONS 

• One or two single-ended SCSI ports 

• Each port supports synchronous SCSI transfers (4 Mbyte/sec. transfer rate) 

• Fui! concurrent operation, including concurrent access to both SCSI busses and 
concurrent operations on up to i4 attached SCSI devices 

• All 8 SCSI phases supported 

• Supports variable SCSI block lengths 

• All avalabie SCSI devices supported: disks, optical disks, tapes (including 1 /2” 
tape cartridges), printers, etc. 

ADDITIONAL ONBOARD FEATURES 

• Local intelligence (68000) controls system-level functions 

• Easy-to-use software interface (lOPB structure) 

• Prefetch caching dynamically controllabie on a per-IOPB basis 

• Full track caching 

• Deep buffer enables application-specific caching algorithms 


REFERENCES 

ANSI X3.131-1986 SCSI Specifications 
VMEbus Bus Specification, Revision C.1 

CONVENTIONS 

This section detals many of the writing conventions used throughout the manual. In addition, it gives 
many of the technical conventions. 

• The SCSI port provided by the motherboard is referred to as Port 0 or the 
primary SCSI bus. The port provided by a SCSI daughter card Crf installed) is called 
the Port 1 or the secondary SCSI bus. 

• "Byte" represents 8 bits; "word” represents 16 bits (2 bytes); and longword" represents 
32 bits (2 words, 4 bytes). 
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• Binary (single bit) data Is represented as either '1' or 'O'. 

• To represent hexadecimal numbers, the manual adopts the C language notation. 
Decimal numbers are shown as decimal digits. For exampie: 

0x29 = 29 hex 
41 41 decimal 

• When used in the context of a single bit of data, the term "set" means that the bit is a 
one O')- 

• Similarly, the term "cleared" means that the bit is a zero (O')- 

• In many cases, bits, bytes, and words are marked '' RESERVED". If the value of the bit, 
byte, or word is determined by the host (Le., sent to the controller), the value must be 
cleared fO', 0x00. or 0x0000). 

• If the value is returned by the controiier, it is reserved for future use by interphase. The 
user should not rely on these values to be consistent through different revisions of the 
product. 

• When showing binary representations of bytes or words, the diagrams may have many 
bits which do not have names. These are RESERVED. As an example: 


□i 


lEj 

lej 

Qli 




LlLlJ 

■1 

□] 

Q 

□] 

□] 

[H 

[H 


Sanple 


,3 


- SaMple 3 
>-Sample 2 


Bits 10 and 11 are called Sample 1, bit 7 is called Sample 2, and bit 6 is called Sample 
3. All other bits are RESERVED. 
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Figure 1-1. V/SCSI4210 Jaguar Block Diagram 
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INSTALLATION 


OVERVIEW 


Before attempting installation, read this chapter thoroughly to insure the safe installation of the Jaguar into 
your system, if you have any questions regarding installation which are not answered in this chapter, please 
contact interphase Customer Service at (214) 919=9000. 


The Jaguar is instalied into the VMEbus system using the following steps: 

• Visual inspection 

• Set Onboard Jumpers 

• Set Onboard Switches 

• Set SCSi Termination 

• Power Off System 

• Cabling Procedure 

When installing the Jaguar, the following WARNING must be adhered to. 

WARNING 


mmmmmBmmamaaammaamammmammmmammmmmmmmmmamwmmmmmamBBB 

i* DiAMAGE can muM if Improper 

cotmectk^aretnadSL planting 

lo (»>rmecl power sources lo ^ Vl^bus for the 
puipose of Iseding ibe userndeBried 

A ^ C$ should to 

ihai ai boards hilled 09^ 

Z. ' Go NOT 'IisM or apply pow^ to a damaged 
boards l^oloob$^dil$wa»^ci^ 
la ssdett^ damaga 03 the lx>anl antd^^ 

S. CaiJtoRt The dagw le extrem^y ea^^ive to 
eiecho^Eaticciadh^ 

Jbe damaged If hailed in^opei^. Int^hase 
ships the board ericioseci In a ahti>siatio 
h8^< Upon reoelit of the boards t^lhe prc^ser 
measiaes h> idimlnate board damage due to ESO 
weeor a Vfffst gimuKl strap or other grountirig 
device}* 


The installation procedure wili vary depending on the desired configuration. Variables include: 

• One or two SCSI ports (7 SCSI devices per port). 

• Single-ended vs. differential SCSI operation for each port. 

• Use of P4 connector to interface widi a printer. 

• Front panel I/O vs. routing SCSi signals off the P2 connector (to determine the 
location of the connectors, refer to figures 2-1 & 2-2). 
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The following table summarizes the V/SCSI 4210 products that are available from Interphase to 
implement various combinations of the cdxsve functions. 

Tabie 2>1. V/SCSI 4210 Products 


PRODUCT 

DESCRIPTION 

Singie-ended V/SCSI 

4210 Jaguar Motherboard 
(Fun P2 connector) 

ProvideB one aingle-ended SCSI port whose signals can be routed 
off either P3 or R2. TMs board uses rows A, 

B, and C of the R2 oonneclor. 

Single-ended V/SCSI 4210 

Jaguar Motherboard 
(Row B connector) 

Provides one singie-ended SCSI port whose signals can 
be routed off P3. Thto board only uses row B of the P2 
oonneclor. 

Differential V/SCSI 4210 

Jaguar Motherboard 
(FuH P2 Connector) 

Has one dMarenlai SCSI port whose signals can be 
routed off eithsr P3 or R2. It usee rows A, B, and C of 
the R2 oonneclor. 

Differential V/SCSI 4210 

Jaguar Motherboard 
(Row B Connector) 

Has one dffferential SCSI port whose signals can be 
routed off P3. It only uses row B of the P2 connector. 

Single-ended V/SCSI 4210 
Daughter Card 

Adds one single-ended SCSI port to any of the above 
motherboards. The signals from this port may be routed 
off either P4 or P2 If the card is installed on a 
motherboard with fril P2 I/O. If ffie card is installed 
on a motherboard that uses P2 Row B only, Its signals 
can only be routed off P4. 

DNferentiai V/SCSI 4210 

Daughter Card 

Adds one dffersidial SCSI port to any of the above 
mcMherboards. If Instalod on a singie-ended motherboard 
wffh ful P2 I/O, this cardb signals can be routed off 
either P4 or P2. However, tf M is installed on any 
differential motherboard 0ul P2 or row B onl^. Its 
signals can only be routed off P4. (This is because 
there are an ^sufficient number of ^ns available on 

P2 to accommodate two dHferenlial SCSI ports.) 

V/SCSI «io Primar Pnt 

Daughter Ctfds 

Adds one printer port to any of the above motherboards. 

One variation of this card supports Cmtronics *and 

Dataproducte •Short Line prirffsis. The other supports 

Dataproducts •Long Line printers. The signals from this 
port can only be roulsd off P4. 

V/SCSI 4210 P2 Adapter 

Card 

Routes SCSI signals off the P2 connector (plugs into the 

VMEbus badcpiane) 


NOTES: 

None of the drivers on the above products are convertible. That is, a board with single-ended SCSI 
drivers cannot be converted to differential, and vice versa. However, a singie-ended motherboard 
can have a differential daughter card, and a differential motherboard can have a single-ended 
daughter card. 







































INSTALLATION 


As noted previously, the SCSI port provided by the motherboard is referred to as Port 0 or the 
primary SCSI bus. The port provided by a SCSI daughter card (if installed) is called the Port 1 
or the secondary SCSI bus. 

By referring to the above table, you should be able to determine the different I/O configurations 
allowed for your setup. For example, assume that you have a single-ended motherboard (full P2 
I/O) that has a single-ended daughter card installed. This setup provides two single-ended SCSI 
ports. Signals from these ports can be routed off P3 and P4 for front panel I/O. Or, if desired, one 
or both ports could be routed off P2. To determine the location of the connectors, refer to the 
figure on page 2-4 or 2-5. 

As another example, assume that you have purchased a differential motherboard (full P2 I/O) that 
has a printer port daughter card installed. You may route signals for the differential SCSI pc^ off 
either P3 or P2. The printer must be connected to P4. 

If you plan to route SCSI signals off the P2 connector, you may wish to refer to the discussion on 
pages 2-19 & 2-20 before proceeding with the installatim. 

VARIATIONS IN BOARD LAYOUT 

From an installation standpoint, there are three basic variations in the layout of the Jaguar motherboard. 
These versions differ in both the number arKi placement of jumpers and switches on the boards. 

To determine which version of the board you have, examine the 12-character artwork code printed on edge 
of the solder side of the motherboard. The artwork code has the following format: PB-xxxx-xxx-xxx, where 

A » dll oupiioiluiIidilu uiiaiowun. 

• If the code is PB-OTTO-xxx-xxx or PB-0910->oor-XOA, then your board has the layout shown 
in the figure on page 2-4. 

* If the code te PB^773-xxx-x}or, tiien your board has the layout shown on page 2-5. 

The drawings on the next three pages depict the three board layouts. These layouts provide information 
that you wili need in order to install your board, including the location of the jumpers, switch blocks, cable 
connectors, and daughter card (if installed). 

The figure on page 2-7 depicts three of the four Jaguar daughter cards - singie-ended, differential, and 
Centronics/Dataproducts Short Line printer port (The fourth daughter card, which provides a printer port 
for Dataproducts Long Line printers, does not have any settings that can be changed.) 
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NOTES: The above drawing depicts typical Jumper and switch settings. Please note that the settings on your 
board may be different from those shown above. 

On boards with PB-*0910-xxx-XOA artworlr, the fuse (F1) is horizontal, not vertical as shown above. 
However, it is located in the same area of the board. 

The actual PCS locator for "Switch Block SWI” is UN3 on boards with PB-0770-xxx-xxx artwork and 
UR5 on boards with PB-0910-xxx-XOA artwork. This switch block is referred to as Switch Block SW1 
throughout this chapter to simplify the discussion of the switch settings. 
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(Artwork VOI^OIl PB-0773r.t!X-j!CGr) 



NOTES; The above drawing depicts typical Jumper and switch settings. Please note that the settings on your 
board may be different from those shown above. 

The actual PCS locator for "Switch Block SW1" on boards with PB-0773-xxx-xxx artwork is UN3. The 
actual locator for "Switch Block SW2” is UK2. These switoh blocks are referred to as Switch Blocks SW1 
and SW2 throughout this chapter to simpify the discussion of the switch settings. 
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SINGLE-ENDED 
DAUGHTER CARD 



DirrEREN! iAL 

DAUGHTER CARD 



CENTRONICS/DATAPRODUCTS 
SHORT UNE DAUGHTER CARD 


NOTE: The Dataproducts Long Line 
daughter card does not have any 
junipers or terminating resistors 
that the user should change. 
Therefore, it is not shown on this 


page. 

Figure 2-4. V/SCSI 4210 Jaguar Daughter Cards 
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INSTALLATION PROCEDURE 

For proper installation, it is imperative that you follow the steps below; 


STEP 1. VISUAL INSPECTION 

Before attempting the installation of this board, make sure you are wearing an anti-static or 
grounding device. Remove the Jaguar board from the anti-static bag, and visually inspect it to 
ensure no damage has occurred during shipment A visual inspection usually is sufficient, since 
each board is thorougNy checked at interphase just prior to shipment. 

If the board is undamaged and ail parts are accounted for. proceed with the installation. 

STEP 2. SET ONBOARD JUMPERS 

Set all onboard jumpers so that the Jaguar is properly configured for operation within your system. 
The board layouts on pages 2-4 - 2-6 show the location of the jumpers. To determine which board 
layout you have, please refer to the discussion "Variations in Board LayouT (page 2-4). 

TERMINATOR POWER TO PRIMARY SCSI BUS 

On all Jaguar board layouts, JA1 is used to connect terminator power to the 
primary SCSI bus. Placing a jumper in JA1 connects the power. The Jaguar is 
shipped with a jumper installed in JAI (factory default setting). 

OSaLLATOR TEST JUMPERS 

The jumpers used for oscillator testability differ from one board layout to another. 
In all cases, however, they should be left in their factory default settings. The 
jumpers are as follows: 

• On the PB-0770-x»r-x»r and PB-910-xx}r-XOA board layout, JA2 and JA3 
are oscllator test jumpers. Both must be left In their factory default 
settings (lumpers Installed). 

• On the PB-0773-)oor-x)or board layout, JA2. JA3, JA4, and JA5 are 
oscllator test jumpers. All must be left in their factory default settings 
(Jumpers Installed In JA2, JA3, and JA5; no Jumper In JA4). 

EPROM SIZE SELECTION 

The jumper used for EPROM size also varies depending on the board layout. In 
all cases, however. It should be left In Its factory default setting. The jumper 
used to set EPROM size on the various motherboards is as follows: 

• On the PB-0770-xx)r-}oor and PB-910-xor-XOA board layout, JA4 selects the 
EPROM size. Jumpering together 1^2 selects a 27512 64K EPROM. 
Jumpering 2 **^ together selects a 27256 32K EPROM. The factory default 
setting is 2^3. Do not change this setting. 
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• On the PB*0773-xct-xcr board layout. JA6 gftlftrt.s the EPROM sizCc Jumpp-ring 
together V**2 selects a 27512 64K EPROM. Jumpering 2«*^3 together 
selects a 27256 32K EPROM. The factory default setting is 2*^3. Do not 

change this setting. 

VMEbus REQUEST LEVEL 

The Jaguar's VMEbus request level can be set from 0 (lowest) to 3 (highest). 

« On the PB-0770-ioof-m’and PB^IO-joor-XOA board layouts, JA5,JA6. and 
JA7 are used to set the VMEbus request level. The ^ctory de^ult setting 
Is for bus request level 3. To change this setting to a different level, refer 
to the Jumper settings depicted below. 

• On the PB-0773^oor-x»r board layout, JA7, JA8, and JA9 are used to set 
the VMEbus request level. The factory default setting is for bus request 
level 3. This can be changed. To do so, refer to the jumper settings 
shown below. 


NOTE 
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Figure 2-5. VMEbus Request Priority Jumper Settings (Motherboard) 

EARLY RELEASE OF VMEbus BBSY* 

This feature is only provided on the PB-0773-x»r-xx)r board layout. The JA10 
Jumper block determines whether the Jaguar wBI use standard or early release 
VMEbus arbitration when it is the bus master. If the jumper is set for standard 
release (jumper IN), the VMEbus signal BBSY* is released after the last cycle is 
completely finished. If the jumper is set for early release (jumper OUT), BBSY* is 
released at the start of the last cycle to allow for rearbitration during the last cycle. 

The -0773 is shipped with no jumper in JA10. This factory default setting selects 
early release of BBSY*. Placing a jumper in JA10 selects standard release of 
BBSY*. 


NOTE 


standi (The fieattira is msi 

selactaMe on these boards.) 
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DAUGHTER CARD JUMPER SETTINGS 

If your setup Includes a daughter card. It may also be necessary to set some jumpers or. 
the card. To determine the location of the jumpers, refer to the figure on page 2-6. Note 
that the Dataproducts Long Line Daughter ^vd does not appear in the figure, since it does 
not have any settings that can be changed. 

For darity, the daughter card jumpers are grouped according to the type of daughter card, 
instead of the jumper function. 

JUMPERS USED ON SINGLE-ENDED AND DIFFERENTIAL SCSI DAUGHTER 
CARDS 

On both the single-ended and differential daughter cards, JA1, JA2, and JA3 are 
used to set the SCSI Bus ID of Port 1. JA3 is the most significant bit of the address 
and JA1 is the least significant blL The factory default setting is SCSI Address 0. 

Placing a jumper in JA1, JA2, or JA3 selects a ”1" (ON) for that bit. Leaving a 
jumper out selects a "0” (OFF) for that bit. The following table shows the possible 
combinations: 

Table 2-2. Setting SCSI Bus ID Of Port 1 


SCSI ID 

JA3 

JA2 

JA1 I 

0 

OFF 

OFF 

OFF I 

1 

i ' 

OFF 

OFF 

ON 

2 

OFF 

ON 

OFF 

3 

OFF 

ON 

ON 

4 

ON 

OFF 

OFF 

5 

ON 

OFF 

ON 

6 

ON 

ON 

OFF 

7 

ON 

ON 

ON 


NOTE 


'Rie secondary bus ID Is also spedHed In ^ Ooniroilef initidization 
filocic $ee*Seoeadd^ 

Itie sacondsay SC^I^ bos ID b Ihe Cornmiler Bioc^ 

oari optlc^y overtieb die {0^^ 


Both the single-ended and differential daughter cards have a jumper used to 
connect Port 1 to SCSI terminator power. This jumper is JA4 on the single-ended 
daughter card and JA5 on the differential daughter card. Installing a jumper 
connects the port to the terminator power. Both daughter cards are shippkl with 
terminator power enabled for Port 1 (jumper installed). 
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The differential daughter card uses JA4 for testing the oscillator. This jumper 
should be left in its factory default setting (jumper installed). 


JUMPERS USED ON CENTRONICS/DATAPRODUCTS SHORT UNE DAUGHTER 
CARD 

The printer port that supports Centronics and Dataproducts Short Line printers has 
two Jumpers, JA1 and JA2. Jumper JA1 is used to select the type of printer 
desired. The card Is shipped with a jumper installed in JA1. This configures the 
card for use with a Centronics pririter. To configure the port for use with a 
Dataproducts Short Line printer, remove the Jumper from JA1. NOTE: For details 
on terminating the daughter card correctly for your printer, refer to p. 2-11. 

JA2 Is used for testing the oscUator and should be left in its default setting (jumper 
installed). 

JUMPER USED ON DATAPRODUCTS LONG UNE DAUGHTER CARD 
The printer port that supports Dataproducts Long Line printers has one jumper. 
JA1. It is used for testing the osdiator and should be left in its default setting 
(jumper installed). 
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JUMPERS AMD SETTINGS USED ON SURFACE MOUNT -JAGUAR 

Refer to figure 2-6 for the location of jumpers contained on the 4210 Surface Mount (SMT) 
Jaguar. 


JUMPERS: 


1-8 

F 

12MHz CPU 


0* 

16.666 MHz CPU 

2-7 

p* 

SSPEEDO 

3*6 

F* 

SSPEED1 

4-6 

F* 

SSPEE02 


Table 2-3. Oscllator 2 And JA1 Frequencies 


FREQUENCIES 

2-7 

3-6 

4-5 

28.302 

0 

F 

0 

24.000 

F 

F 

F 


JA2 

1-2 

F 

12MHz CPU and 4MB/s SCSI 



0* 

Other combinations 

JA3 

1-2 

0* 

Terminator power on 



p 


JA4 

1-2 

0* 

Late release 



F 

Early release 

JA5 

1-2 

F* 

Software switch, r^servecj 

JA6 

1-16 

F* 

Software switch, reserved 


2-15 

F* 

Software switch, reserved 


3-14 

F* 

Software switch, reserved 


4-13 

F* 

Software switch, reserved 


5-12 

F* 

Software switch, reserved 


6-11 

F* 

Software switch, reserved 


7-10 

0* 

DISABLE Extended Power up diagnostic 



F 

ENABLE Extended diagnostic on power up 


8-9 

Q* 

SCSI Res^ on power up 



F 

Disable SCSI Reset on power up 

JA7 

1-2 

0 

Noisy DTACK 



F* 

No noise -on DTACK 

JA8 

1-4 

F 

Address 16 for 27512 


2-3 

0* 

5V to pin 1 of eproms for 27256 

JA9 

1-8 

F* 

Bus Request 0 


2-7 

F* 

Bus Request 1 


3-6 

F* 

Bus Request 2 


4-6 

0* 

Bus Request 3 
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JA10 1-8 

F* 

Bus grant out 0 

2-7 

F* 

BG01 

3-6 

F* 

BG02 

4-5 

0* 

BQ03 

JA11 1-8 

F* 

Bus grant in 0 

2-7 

F* 

BG11 

3-6 

F* 

BG12 

4-5 

0* 

BQ13 

JA10-8J11-1 

0* 

BQ daisy chain 

JA10-7J11-2 

0* 

BG daisy chain 

JA10-6 J11-3 

0* 

BG daisy chain 

JB1 1-18 

F* 

SW3 SCSI ID 0 

2-17 

F* 

SW2SCSI IDO 

3-16 

F* 

Swi SCSI ID 0 

4-15 

0 

SW4 Short I/O address 7000 

5-14 

F 

SW5 addresses 

6-13 

F 

S\N6 addresses 

7-12 

F 

SW7 addresses 

8-11 

0 

SW8 addresses 

9-10 

0 

F* 

SW9 Supervisor mode 

User mode 


Lengend: 0: ON (Jumper in), F: Off (Jumper Out), * Denotes Default 

NOTE 


le 


uys: mo^. The etjoi^etatsleepf^les la^ <»nly. 


Table 2-4. Setting SCSI Bus ID of Port 0 


1 SCSI ID 

Jumper Settings (SMT) | 

JB1 (1-18) 

JB1 (2-17) 

JB1 (3-16) 

1 0 

OFF 

OFF 

OFF 

1 

ON 

OFF 

OFF 

2 

OFF 

ON 

OFF 

3 

ON 

ON 

OFF 

4 

OFF 

OFF 

ON 

5 

ON 

OFF 

ON 

6 

OFF 

ON 

ON 

7 

ON 

ON 

ON 
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STEP 3. SET ONBOARD SWITCHES 

THRU-HOLE AVAILABLE SWITCH OPTIONS 

The Jaguar motherboard has either one or two switch blocks, depending on which 
version of the board you have. All Jaguar motherboards have a switch biock 
(referred to in this chapter as "Switch Block SWI") that allows you to set the 
following parameters: 

• Base address of the Jaguar's 2 Kbyte short I/O RAM 

• Allowed VMEbus address modifiers 

• SCSI bus 10 of Port 0 

Switch Block SWI is the only switch biock on boards with the layout shown on 
page 2-4 (artwork codes PB-0770->oor-;oor and PB-910-x»r-XOA). 

Boards with -773 artwork have an additional switch block (referred to in this chapter 
as "Switch Block SW2") that allows you to specify whether or not the Jaguar will: 

• Reset the SCSI bus upon power-up or reset 

Remove SYSFAIL* immediately after coming out of reset or perform 

AytnnrlArl nnuior-iin Hiannnjetirs hAfnre remnvinn <>Y!RFAII * 

--• r -T' ——3b»* —ii”.' . W.........g 


NOTE 


^ boasd Wi 

of how boards batxSe SYSFAIL^t ref^ 

‘y^S!*’^*^*^^?^^*^**^^^^***^^**^^^^*^^?**^* ........S. .VkiH .A... 


An "OFP switch setting equals logic 1. An "ON" setting equals logic 0. 

The following sections describe how to set the switches to meet the requirements 
of your specific installation. 


SETTING BASE ADDRESS OF SHORT I/O SPACE RAM 

Switches 4 - 8 of Switch Biock SWI are used to set the base address of the 2 Kbytes of 
short I/O space RAM on the Jaguar. Ail interaction between the host and the Jaguar takes 
place in this 2K space. 

The switches correspond to VMEbus address lines A15-A11, respectively, as shown below: 


M6 
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Table 2-5. Switches Used For Short I/O Base Address 


1 SWITCH * 

ADDRESS BIT 

SW1 -4 

A11 

SW1 -5 

A12 

SW1 -6 

A13 

SW1 -7 

A14 

SW1 -8 

A15 


An OFF switch has a value of'T and an ON switch has a value of X)'. To determine the ON 
vs. OFF setting of the switches, refer to the appropriate board layout on pages 2-4 & 2-5. 

The short I/O base address must be a multiple of 0x800. The following table shows the 
switch settings for all possible base addresses. 
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NOTE 

xanmmxtmBBOxamsmaaam 


Table 2-6. Base Address For Short I/O RAM 


ADDRESS 

SWITCH SETTINGS 

8 7 6 5 4 

0000 

0 0 0 0 0 

0600 

0 0 0 0 F 

1000 

0 0 0 F 0 1 

1800 

0 0 0 F F 

2000 

0 0 F 0 0 

2800 

0 0 F 0 F 

3000 

0 0 F F 0 1 

3800 

0 0 F F F 

4000 

0 F 0 0 0 

4800 

0 F 0 0 F 

5000 

0 F 0 F 0 

5800 

0 F 0 F F 1 

6000 

0 F F 0 0 1 

6800 

0 F F 0 F 

7000 

0 F F F 0 

7800 

0 F F F F 

8000 

F 0 0 0 0 1 

8800 

F 0 0 0 F 

9000 

F 0 0 F 0 

9800 

F 0 0 F F 

AOOO 

F 0 F 0 0 

A800 

F 0 F 0 F 

BOOO 

F 0 F F 0 

B800 

F 0 F F F 

COOO 

F F 0 0 0 

C800 

F F 0 0 F 

DOOO 

F F 0 F 0 

D800 

F F 0 F F 

EOOO 

F F F 0 0 

E600 

F F F 0 F 1 

FOOO 

F F F F 0 

F800 

F F F F F 
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SETTING THRU-HOLE ADDRESS MODIFIERS ALLOWED IN SHORT I/O 
ADDRESS SPACE - - - 

Switch 9 in Switch Block SW1 is used to select the address modifiers that are permitted in 
the short I/O address space. If the switch is on, only short supervisor accesses are 
permitted (address modifier 0x2D only). If it is off. then both 0x2D and 0x29 address 
modifiers are allowed. 

SETTING SCSI BUS ID Of Port 0 

Switches 1 - 3 of Switch Block SW1 are used to set the SCSI Bus ID for the Jaguar's Port 

0 . 

A switch in the ON or CLOSED position selects a V for that bit. A switch in the OFF or 
OPEN position selects a 'T to the bit The following table shows the possible 
combinations; 


Table 2-7. Setting SCSI Bus ID of Port 0 



SwiI 

tch Settings (SW1) 


1 

2 

3 

0 

ON 

ON 

ON 

1 

OFF 

ON 

ON 

2 

ON 

OFF 

ON 

3 

OFF 

OFF 

ON 

4 

ON 

ON 

OFF 

5 

OFF 

ON 

OFF 

6 

ON 

OFF 

OFF 

I 7 

OFF 

OFF 

OFF 


NOTE 




The ptknagy SCSi busTD Is also specifieEl ^the ControlBr ihSIgilzatron Sock. See 
♦Plenary S<^SusiP^lotsatedl^Chap^ Hie pdmary SCSI bus iD 


bus ID. 
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SELECTING SCSI BUS RESET AFTER POWER-UP/RESET 
(PB-0773-x»f-xxx Board Layout Only) 

When Switch 1 in Switch Block SW2 is set to the "ON" position, the Jaguar will reset the 
SCSI bus whenever the Jaguar is turned on or reset Setting the switch to the "OFP 
position disables this feature. This option may be useful in some multi-host adapter 
systems. 

SELECTING REMOVAL OF SYSFAIL* AFTER RESET / ENABLING 
EXTENDED DIAGNOSTICS (PB-0773-ioof-xxx Board Layout Only) 

When Switch 2 in Switch Block SW2 Is set to the "ON* position, the Jaguar will remove the 
VMEbus SYSFAIL* signal immediately after coming out of reset. When it is set to "OFP, 
the Jaguar will execute a series of ext^ed diagnostics before clearing SYSFAIL* Please 
allow 15 - 20 seconds for the extended diagnostics to complete. 

STEP 4. SET TERMINATION 

SCSI specifications require the bus to be terminated at both ends of the SCSI cable. No other 
termination is allowed. Otherwise, a bus impedance mismatch wll occur. 

The Jaguar's primary port (Port 0) and optional secondary SCSI port (Port 1) are each provided 
with separate terminating resistors. The following statement applies to either port: if the port is at 
either end of the SCSI cable, the port's terminating resistors should be left in place. If the port is 
not at the end of the cable, the termination should be removed. 

Note that the optional printer port daughter card has different termination requirements than the 
SCSI daughter cards. These requirements are described in the subsection on daughter card 
termination, below. 

TERMINATION ON MOTHERBOARD 

All versions of the Jaguar motherboard are shipped with termination installed. On single- 
ended motherboards, these resistor SIPs are labelled RNI, RN2. and RN3. On differential 
motherboards, these resistor SIPs are labelled RNI, RN2, RN3, RN4, RN5, and RN6. To 
locate the resistors, refer the appropriate board layout on page 2-4 or 2-5. These resistors 
provide termination for Port 0. If Port 0 is not at one eixi of the SCSI cable, remove these 
resistors from the motherboard O-o. remove RNI, RN2, and RN3 from a single-ended 
motherboard, or remove RNI through RN6 from a differentiai motherboard). 


TERMINATION ON DAUGHTER CARD 

The termination on your daughter card (if you have one) depends on the card type. Refer 
to the figure on page 2-7 to determine the location of the terminating resistors. The different 
termination schemes are summarized below: 

• Single-ended daughter card: Resistors RNI, RN2, and RN3 on the 
daughter card (not the motherboard) provide termination for the secondary 
SCSI bus (Port 1). If the Jaguar is not at one end of the SCSI cable, these 
resistor SIPs should be removed. 
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Diffflrflnttol ftoii n hty r^tri- Rft gtetn rg RN3^ RN4, SfXJ RN5 OH th6 d€lUQht8r 
card provkte termination for Port 1. If Port 1 is not at one end of the SCSI 
cable, these resistor SIPs should be removed. 

• Dataproducts Ijong Line printer port: The terminators are set correctly for 
a Dataproducts Long Line printer and should not be changed. 

• Dataproducts Short Line/Centronics printer port: 

For use with Dataproducts Short Line printer 

« R!^ and RN3 should both be 390& 

For use with Centronics printer 

• RN3 should be 470o 

• RN2 is not used (if RN2 is installed on the card, remove it) 


NOTE 



STEP 5. POWER OFF SYSTEM 

Once the board is configured, ensure that the host system and peripherals are turned OFF. 


CAUTION 
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STEP 6. CABUNG PROCEDURE 

The cabling procedure deperxis on how you wish to configure the system. Your options are 
summarized below. 

For a complete description of each of the cables mentioned below, please refer to Appendix B. The 
P2 Adapter is discussed in detail in the next section. 


To implement: 

A single-ended SCSI bus 
using Port 0 


A single-ended SCSI bus 
using Port 1 


Your cabling options are: 

For front panel I/O, connect a standard, single- 
ended SCSI cable to P3 (motherboard). For back 
panel I/O, connect the standard cable to the P4 
connector on the P2 adapter. 

For front panel I/O, connect a standard, single- 
ended SCSI cable to P4 (motherboard). For back 
panel I/O, connect the standard cable to the P3 
connector on the P2 adapter. 


A differential SCSI bus 
using Port 0 


A differential SCSI bus 
using Port 1 


For front panel I/O, connect a standard, 

differential SCSI cable to P3 (motherboard). For 
back panel I/O, connect the standard cable to the 
P3 connector on the P2 adapter. 

For front panel I/O, connect a standard, 

differential SCSI cable to P4 (motherboard). For 
back panel I/O, connect the standard cable to the 
P4 connector on the P2 adapter. 


NOTE: As noted previously. If you have a 
differential daughter card installed on a differential 
motherboard, the daughter card's signals must be 
routed off P4. (There are not enough pins 
avalable on P2 for two differential ports.) 


A printer port Connect the printer to P4 (nratherboard) using the 

appropriate cable (Centronics. Dataproducts 
Short Line, or Dataproducts Long Line). 


P2 ADAPTER CARD 


In order to route SCSI signals off the P2 connector, you will need an Interphase Jaguar P2 
Adapter (part no. PB-0870-000-000). The card allows you to route one or both SCSI ports 
off the backplane. However, as noted above, only one differential SCSI port can be routed 
off P2, due to the limited number of pins on P2. 

The P2 Adapter Card is depicted below: 
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VMEbus PI AND P2 CONNECTOR CONFIGURATIONS 

All versions of the Jaguar have the same VMEbus PI connector configuration. Certain 
versions of the Jaguar oniy utiize row B of the P2 connector, whiie others use ali three rows 
onP2. 

INSTALLING THE CABLE(s) AND BOARD 

1. Ensure that you have the correct cabies for your configuration. (Refer to "Cabling 
Procedure", above, and Appendbc B,) 

2. Make sure that the system and all peripherals are turned OFF. 

3. For Front Panel I/O. connect the cable for Port 0 to P3 and the cable for Port 1 fif 
used) to P4. If you are using the printer port, your printer must be connected to the 
Jaguar via P4. 

For P2 I/O. plug the P2 Adapter Into the VMEbus backplane, on the side opposite 
from the connector into which the Jaguar's P2 connector will be installed. The 
adapter is keyed to prevent it from being plugged in incorrectly. 

Connect the cable(s) to the adapter as follows: 

Type Of Port: Plug SCSI Cable Into This Connector 

On The P2 Adapter: 


Single-ended motherboard, Port 0 P4 

Single-ended motherboard, Port 1 P3 

Differential motherboard. Port 0 P3 

Differential motherboard. Port 1 P4* 


* As noted previously, if you have a Jaguar with two differential SCSI ports. Port 
1 must be routed through the front panel. 

4. Carefully slide the Jaguar into the VMEbus card slot. It should slide all the way in 
without any difficiity. If it doesn't, pull it out and check to make sure that there are 
no cables in the way. 
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5. Once the board is property seated in the slot, tighten the captive mounting screws 
on each end of the board. 

6. Connect the SCSI devices to the SCSI cabie(s), following the directbns given by 
the device manufacturers. Connect the printer (if printer port is installed) to the 
printer cable. 
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CHAPTER 3 

JAGUAR SYSTEM INTERFACE 


OVERVIEW 

The host communicates with the Jaguar through 2048 bytes of short I/O space located on the Jaguar. 
This memory is mapped into the short I/O space of the vMEbus. Every location can be both written to 
and read from, physically, by the host at any time, but the protocol of the Jaguar MACSI System 
Interface puts some restrictions upon when certain areas should be accessed. Also, some areas are 
logically write only or read only. MACSI partitions this RAM into six major sections: 

• Master Control/Status Block (MCSB) 

• Master Command Entry (MCE) 

• Command Queue (CQ) 

• Host Usable Space (HUS) 

• Command Response Block (CRB) 

• Controller Specific Space (CSS) 

The Master Control/Status Block is used to pass and receive informatbn relative to the overall 
operation of the Jaguar. The Master Controi/Status Block is 16 bytes long. 

The Master Command Entry is used to issue commands to the Jaguar before the Command Queue and 
work queues have been initialized. Typically, it will be used only when initializing the Command Queue 
and work queues. It does, however, provide a mechanism to is^ a command to the Jaguar even if the 
Command Queue and all work queues are full. The single slot of the MCE has the same 12-byte format 
as any other Command Queue entry. Space must be reserved in the Host Usable Space (HUS) portion 
of the short I/O space for the lOPB that is pointed to by the MCE. 

The Command Queue consists of a user-programed number of Command Queue entries. Each 
Command Queue entry includes all of the Information that is needed for the Jaguar to find, execute, and 
respond to the commands contained in an lOPB. The Command Queue is circular, and it is up to the 
host to keep track of the next Command Queue entry that it can use. Because the queue is circular, the 
Jaguar infers chronological ordering of commands. Each Command Queue entry is "busy” only until the 
Jaguar can transfer the command to a work queue and then free its slot in the Command Queue. The 
number of entries in the Command Queue is programmed via the Initialize Controller commarxl. The 
actual size of the Command Queue equals the number of entries times 12 bytes. 

The Host Usable Space is free-form memory space accessible to both the host and the controller. It 
is typically used for iOPBs. However, for multiprocessing applications, this is a convenient place for 
semaphores between CPUs. The amount of HUS availabie is determined by the number of Command 
Queue entries defined when the Command Queue is initialized and by the length of the Command 
Response Block. For example, if the Command Queue is initialized with 10 entries and the Command 
Response Block of 76 bytes is defined, there wii be 1704 bytes of HUS available. The Master 
Control/Status Block, Master Command Entry, and the Controller Specific Space always occupy a total 
of 148 bytes. 
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TheCommand Response Block is used by the Jaguar to post command completion status. The lOPB 
itself and related status information are returned to the Command Response Block, in addition, if enabled 
to do so, the Jaguar uses the CRB to signal that space has become available in the Command Queue 
to accept new entries. The offset of the Commarxl Response Block is defined during initialization. 

The Controller Specific Space is a 120-byte space used by the Jaguar to post the Configuration Status 
Block. The Jaguar uses the Configuration Status Block to report the firmware revision level, information 
on product number and variations, available buffer space arid the SCSI bus IDs that it is using. 


Offset From Short 
I/O 

Base/Vddress 

15 

14 

13 

12 

11 

10 

1 

1 

1 

1 

5 

1 

3 

2 

1 

1 

+0x0 

To 

♦OxF 

Master Control/Status Block 


+0x10 

To 

+0X1B 

Master Command Entry 

+0x1 C 

To 

+0x93 

Command Queue 

+0x94 

To 

+OX73B 

Host Usable Space 

+OX73C 

To 

+0X787 

Command Response Block 

+0X788 

To 

+OX7FF 

Configuration Status Stock 


NOTE: 


The above memory map is for a Jaguar that has been initialzed with a 10-enlry Command Queue and a 
maximum IOP6 iength of 64 bytes. 


Figure 3-1. Typical Memory Map Of Jaguar Short I/O Space 
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MASTER CONTROUSTATUS BLOCK (MCSB) 

The Master Controf/Status Block (MCSB) consists of the Master Status Register (MSR), the Master 
Control Register (MCR), the Interru^ on Queue Available Register (IQAR). and the Queue Head Pointer 
(QHP). 



MASTER STATUS REGISTER (MSR) 

The Jaguar uses this register to report board level status. From the host point of reference, this 
is a READ ONLY register. However, the contents of this register are not valid for 100 
microsecorxJs following a controller reset. The bits are defined as follows: 


dej 

14 

13 

12 

11 

10 

9 

8 

3 

3 


4 

3 

2 

□ 

0 


L—*^ControUer Mot Available 
—»^Board O.K. 

—Khjeue Flush Complete 
—^-Reserved 


Rgure 3-3. Master Status Register (MSR) 


Bn 0 Controller Not Available (CNA): 

The Jaguar sets this bit to *1' to indicate that it is Not AvaUable to receive a command. 
This condition can be caused either by a controiier reset or by the execution of 
controller diagnostics. CNA wil also be set If a board initialization command fails to 
complete (see Initialize Controiier Command). The Jaguar will dear this bit when it is 
capable of accepting a command. 

Bn 1 Board O.K. (BOK): 

The Jaguar sets this bit to 'T when the power-up diagnostics are completed 
successfully. A t)' indicates that the Jaguar detected a failure during the power-up 
diagnostics or during a board initialize command. 
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The host can start polling the Board OK bit 1CX) microseconds after the board has been 
powered-up or reset. However, you should allow 5 seconds for normal power-up 
diagnostics to complete. Or, if extended power-up diagnostics are enabled (see Chapter 
2), allow at least 20 seconds for these tests to complete. 


Table 3-1. Board OK/Controiler Not Availabie Relationship 


BOK 

CNA 

DESCRIPTION 

D 

B 

The controlier has faled to operate and is not 
capabie of accepting a command. 


1 

Controlier is Not Avaiiabie. If the controller is I 
not stM executing power-up diagnostics, then 1 
it has either taled to execute power-up 1 

correctly or it has failed to complete a board | 
initialize command. | 

1 

1 

The controller has successfully completed I 

power-up diagnostics but it is not capable of I 
accepting a command, because it is I 

executing the diagnostics command. | 


B 

The controiier has compieted diagnostics and I 
is capabie of receiving commands. | 


Bit 2 Queue Flush Complete (QFC): 

The QFC bit is set to 1 by the Jaguar after it performs a flush queue operation. It is 
cleared by the Jaguar after the Rush Queue bit in the Master Control Register is cleared 
by the hc^ (see MCR bit descriptions under Master Control Register for more detail). 

Bits 3-15 Reserved (RSRV): 

These bits are reserved and are cleared to 0 by the Jaguar. 

MASTER CONTROL REGISTER (MCR) 

All bits in this register are both s^ and reset by the host From the Jaguar’s point of reference, 
this is a READ ONLY register. The Jaguar wii never set any of these bits. The bits are defined 
as follows: 




1 1 

12 1 11 1 10 1 9 

1 8 1 7 1 6 1 

5 1 4 1 3 1 2 1 1 1 0 


i^Start Queue Mode 
—^-Reserved 

—^Flush Queue And Report 
—^^Reserved 
—»>Flush Queue 
—»^Reset Controller 
—►SYSFAIL* Enable 
—►Reserved 


Figure 3-4. Master Controi Register (MCR) 
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Bit 0 Start Queue Mode (SQM): 

Untl the Command Queue and work queues are initialized, aii commands to the Jaguar 
must be issued to Work Queue 0 through the Master Command Entry. Once the 
Command Queue and work queues have been initialized, the host starts Queued iOPB 
operation by setting this bit to *1'. The host sets this bit only after it has initiaiized both 
the Command Queue and the work queues. This bit is set only once by the host and is 
never reset during normal operation. The Jaguar wiii acknowledge entering Queued 
iOPB mode by setting the Queue Mode Started bit in the Command Response Status 
Word to *1* (see Command Response Status Word). No interrupt wiii be generated. 

Bit 1 Reserved (RSRV): 

This bit is reserved and must be cleared to 0 by the host 
Bit 2 Flush Queue and Report (FLQR): 


The Rush Queue and Report bit causes the Jaguar to dear aii in Progress commands 
and all queued commands from both the Command Queue and the work queues. Any 
In Progress (currently executing) command wiii execute normaily. 


As each command is deared, a Command Complete Interrupt (with error completion 
status) is generated. At the completion of the entire Rush Queue and Report operation, 
a final Command Complete interrupt is generated. This final Command Complete 

Internjf4 ijcac [i^e i T iir# VSCtOr. WHati thie IfltAmiflt |e riAriArAtAH thA 


Whsn tKie intfimmt 


Queue Rush Complete bit (QFC) will be set in the Master Status Register. The host 
should dear the Rush Queue and Report bit before dearing this last interrupt. The host 
must wait for this final Rush Queue and Report Command Complete Interrupt before 
entering any new commands, because the Jaguar wll continue flushing commands until 
there are no further commands to flush. Thus, any command entered before the Rush 
Queue and Report Command Complete Interrupt will be flushed. 


NOTE 



BHs 3-10 Reserved (RSRV): 

These bits are reserved and must be deared to 0 by the host. 

Bit 11 Flush Queue (FLQ): 

Rush Queue operates the same as Rush Queue and Report except that there is no 
report (Command Complete Interrupt) as each command is flushed. A Rush Queue 
generates only one Command Complete interrupt at the completion of the entire 
operation. The Contrdler Interrupt Vector Register is used for the Command Complete 
Interrupt The host must wait for the Rush Queue Command Complete Interrupt before 
entering new commands, because the Jaguar wRI continue flushing commands until 
there are no further commands. 
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Bit 12 Re 80 t Controller (RES): 

The Reset Controlier bit controls the microprocessor hardware reset line. It also causes 
a RESET on both of the SCSI buses, if the SCSI reset feature is enabled. (The reset 
feature Is available on boards with -0773 artwork. See the discussion of SW2 located in 
Chapter 2 for more information.) 

Obviously, the Reset Controller bit should be used only to recover from extreme error 
conditions. To ensure proper operation, the host must leave this bit set for at least 
70 microseconds. 

Bn 13 SYSFAIL* Enable (SFEN): 

The SYSFAIL* Enable bit enables the Jaguar to drive the SYSFAIL* signal on the 
VMEbus if it detects an internal falure during power-up diagnostics or if the firmware 
enters an unused exception vector. If this bit is 'O', the Jaguar will not drive the 
SYSFAIL* signal under any circumstances. The Jaguar initializes this bit to 'O' after 
power-up. 

The Jaguar does not read the SYSFAIL* Enable bit until detecting an error in the power- 
up test After detecting an error the firmware simply loops on setting the SYSFAIL* line 
to the level specified by the bit (provided that the Jaguar is sufficiently functional to have 
the bit cleared). 

The host may turn off SYSFAIL* from the Jaguar by clearing this bit. The host may 
enable SYSFAIL* after the Jaguar has been released from reset This operation is 
performed by firmware, and it is possible the Jaguar may dear the bit if it is set too 
soon after power-up. The host should therefore wait 20 seconds after resetting the 
Jaguar before enabling this bit 


NOTE 
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Bttt 14-15 Reserved (RSRV): 

These bits are reserved and must be deared to 0 by the host. 
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INTERRUPT ON QUEUE AVAILABLE REGISTER (IQAR) 

As discussed previousiy. each Command Queue entry only occupies a slot in the Command 
Queue until it is moved into a work queue. Thus, the host will virtually always have slots 
available in the Command Queue for issuing commands. In the unlikely event that the Command 
Queue is full when the host attempts to enter a command, the host must wait until the Jaguar 
transfers a command from the Command Queue to an internal work queue before it can enter 
the next command. 

The host determines that the Command Queue is full by looking at the Go/Busy bit in the next 
available Command Queue entry. The Command Queue is full if the Go/Busy bit of the next 
available Command Queue entry is *1*. if the Command Queue becomes full, the host could 
simply poll the Go bit, watting until the next Command Queue entry becomes available. But the 
Jaguar, through the Interrupt on Queue Avalabie Register, provides for efficient operation by 
optionally interrupting the host when a entry becomes available in the Command Queue. Thus, 
even in the unlikely case that the Command Queue is full when the host tries to enter a 
command, the host need not be concerned with any intimate timing issues of the Jaguar's 
Command Queue. 

The IQAR feature is enabled by setting the Interrupt on Queue Entry Available (IQEA) bit in the 
register. If the Interrupt on Queue Half Empty Enable bit is also set, the Jaguar v^l not interrupt 
until the Command Queue is half empty. Otherwise, the interrupt wBi occur as soon as the 
Jaguar detects one empty entry in the Command Queue. The host should wait until encountering 
the Queue Full condition before setting the IQEA bit Once the IQEA bit is set, the Jaguar 
generate an Intenupt as soon as the necessary queue conditioris are satisfied. Cnee the 
interrupt is generated, the Jaguar resets the IQEA bit 

The level and vector for the IQEA interrupt are suppiied by the host in the iQAR. When the 
necessary queue conditions are satisfied, the Jaguar dears the iQEA bit and generates a 
Command Complete Interrupt with the Queue Entry A\aiiable (CQA) bit set in the Command 
Response Status Word (CRSW) of the Command Response Block (CRB) (see Command 
Response Status Word). Even though the Jaguar provides for efficient operation by providing 
this mechanism for interrupting the host when space becomes avaiiabie in the Command Queue, 
it is preferabie to set up a iarge enough Command Queue so that the foil condition occurs 
infrequently. The numb^ of entries in the Command Queue is set in the Controller Initialization 
Block (see Initialize Contrdler Command). 
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I—►Interrupt Vector 
-►Interrupt Level 


-►Reserved 


-►Interrupt On Queue Half Empty Enable 
-►Interrupt On Queue Entry Available 


Figure 3-5. interrupt On Queue Avalabie Register (IQAR) 

Bits 0-7 Interrupt Vector for the Interrupt on Queue Available (IV): 

The Jaguar uses this byte as the interrupt vector when issuing an Interrupt on Queue 
Avalabie interrupt. This byte is set by the host and is not modified by the Jaguar. The 
host must not modify this byte after setting the IQEA bit 
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Bits a-10 Interrupt Level fbr the Interrupt on Queue Available (IL): 

These three bits determine the interrupt ievei that the Jaguar wHi use when issuing an 
interrupt on Queue Avaiiabie interrupt These bits are set by the host and are not 
modified by the Jaguar. After setting the interrupt on Queue Entry Avaiiabie bit, Bit 15, 
the host must not modify these bits. 

Vaiues of V through T are allowed. An Interrupt level of 'O' is allowed only when the 
IQEA bit is reset 

Btts 11-13 Reserved (RSRV): 

These bits must be cleared to 0 by the host 

Bit 14 Interrupt on Queue Half Empty Enable (IQHE): 

This bit is a flag which causes the Jaguar to generate the Interrupt on Queue Avaiiabie 
interrupt when the Command Queue becomes half empty (rather than as soon as one 
entry becomes avaiiabie). The interrupt on Queue Half Empty Enable (IQHE) bit is vaiid 
only when the IQEA bit is set The IQHE bit is set by the host and is not modified by the 
Jaguar. The host must not modify this bit after it has set the IQEA bit 

BH 15 Interrupt on Queue Entry Available (IQEA): 

This bit is set by the host to request an interrupt on Queue Entry Avaiiabie. The interrupt 
is generated either when the queue is half empty or as soon as one entry is available, 
depending upon the state of the IQHE bit The Jaguar clears this bit prior to generating 
the Interrupt on Queue Avaiiabie interrupt After the host sets this bit requesting an 
interrupt it cannot change any of the other bits in the Interrupt on Queue Available 
Register. 


QUEUE HEAD POINTER 

The Command Queue is a circular queue and the Jaguar requires that the host use the entries 
in the Command Queue in order. The Queue Head Pointer provides a convenient method for the 
host to control the ordering of and the access to the Command Queue. The Queue Head Pointer 
register provides a place for the host to store the address of the next avaiiabie entry in the 
Command Queue. 


I 15 I 14 I 13 I 12 I 11 I 10 I 9 I 8 [ 7 [ 6 I 5 I 4 I 3 I 2 ] 




'HHjeue Head Pointer (Address) 


Figure 3-6. Queue Head Pointer/Queue Head Pointer In Use 


Bits 0-15 Queue Head Pointer (Address): 

This is the address of the next entry in the Command Queue. Since the Jaguar transfers 
commands out of the Command Queue in circular order as soon as it sees the Go/Busy 
bit set, this acidress is not actually used by the Jaguar. 
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The MACS! interface of the Jaguar relies on the chronological order of the Command 
Queue. The host must somehow ensure that the entries in the Command Queue are 
used in chronological order. 

THAW WORK QUEUE REGISTER 

This field is used to restart a work queue that has been frozen after an error has occurred with 
Freeze Work Queue on Error enabled. A queue is thawed by writing the appropriate work queue 
number to the upper byte of the register and then setting Bit 0 (THW). See "Error Recovery 
Tools" in Chapter 6 for additional informatioa 
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——►Reoervod 
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-►Reserved 


Queue 

Work Queue To Be Thawed 


Figure 3-7. Thaw Work Queue Register 
Btt 0 Thaw Work Queue (THW): 

Setting this bit causes the Jaguar to resume execution of commands in the work queue 

specified In Bits 8-15. It then Bit Q fTHW) to acimcwi^gs that the queue has 

been thawed. 

Bits 1-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

Bits 8-11 Number of Work Queue to be Thawed: 

This field specifies the work queue to be unfrozen. Valid entries in the field are 0x1 - OxE 
(for Work Queues 1 -14, respectively). This value must not change while Bit 0, THW, is 
set to 1. 

Bits 12-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 
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MASTER COMMAND ENTRY (MCE) 

The Master Command Entry (MCE) is used to issue commands to the Jaguar before the Command 
Queue and work queues have been initialized. UntI the Jaguar has been commanded to enter Queue 
Mode, all commands must be entered through the MCE. Typically, it will be used only when initializing 
the Command Queue. 

it does, however, provide a mechanism to issue a command to the Jaguar even if the Command Queue 
and all work queues are full. It provides a way to get one command into the Jaguar even when the 
Command Queue is locked up.” 

The Master Command Entry has the same 12-byte format as a Command Queue entry for on-board 
lOPBs. Its fields also have the same definition. The format is as foUows: 



0@fore you issue a command to the Master Command Entry, the lOPB pointed to by the MCE must 
already be written to the Host Usable Space (HUS) portion of short I/O space. 

COMMAND QUEUE 

The Command Queue (CQ) consists of a user-programmed number of Command Queue entries. The 
entries in the Command Queue is set by the host when it initializes the controller. The Command Queue 
is circular, but it is up to the host to keep track of the next Command Queue entry that it can use. 
Because the queue is circular, the Jaguar can infer chroix)logical ordering of commands. The actual size 
of the Command Queue equals the number of entries times 12 bytes. The Command Queue must have 
at least one entry. 

COMMAND QUEUE ENTRY (CQE) 

A Command Queue entry is a 12-byte block containing all of the information needed for the host 
to find and execute a command. Each entry in the Command Queue is '' busy”only until the 
Jaguar can transfer the command to a wo^ queue and then free the entry by clearing the 
Go/Busy bit This mechanism allows a relatively small Command Queue to handle a large 
number of commands. 
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The purpose of the fields in a Command Queue entry wii vary depending on whether you are 
implementing onboard or offboard lOPBs. The format of the two types of Command Queue 
entries are shown below: 


COMMAND QUEUE ENTRY FOR ONBOARD lOPBs: 



COMMAND QUEUE ENTRY FOR OFFBOARD lOPBs: 


Word# 

15 14 13 12 

11 10 

BH 

B 

1 

1 

B 

0x0 

QUEUE ENTRY CONTROL REGISTER || 

0X1 

RSRV 

TT 

MT 

ADDRESS MODIFIER f 

0X2 

HOST ADDRESS (MSW) 

0X3 

HOST ADDRESS (LSW) 

0X4 

lOPB LENGTH 

WORK QUEUE NUMBER | 

0X5 

RESERVED | 


Figure 3-9. Command Queue Entry Format For Onboard And Offboard lOPBs 
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CQE WORD 0: 

QUEUE ENTRY CONTROL REGISTER 

The Queue Entry Control Register (QECR) is used to: 1) kick off command execution, 2) 
acknowledge a command abort sequence, 3) flag a high priority command, and 4) signai 
whether a command is located in short I/O (onboard lOPB) or in system memory (offboard 
lOPB). 


15 




13 


12 


1l|l0|9|8|7|6|5|i|3|2|l|0 


n 


L^Go/Busy 
—^Abort Acknowledge 


-»>High Priority Conmand 
-►Reserved 


-►Fetch Offboard 
-►Reserved 


-►lOPB Type 
-►Resent 


Figure 3>10. Queue Entry Control Register (QECR) 


Btt 0 Go/Busy (GO): 

The Go/Busy bit is set by the host to initiate action on a Command Queue entry. The 
host must assemble the lOPB in the Host Usable Space (HUS) and assemble the entire 
Command Queue entry in the Command Queue before it s^ this bit. The Jaguar moves 
the Command Queue entry and the iOPB into internal memory as soon as it sees the 
Go/Busy bit set Once the IOPB and Command Queue entry are in internal mefTK)ry, the 
Jaguar wll reset the Go/Busy bit to free the Command Queue entry. 

Btt 1 Abort Acknowledge (AA): 

When a command completes with error, ail commands in that work queue can optionally 
be aborted. In addition, all commands in the Command Queue that are destined for that 
work queue are also aborted. This option is specified when the work queue is initialized 
(see Abort Enable bit in the initialize Work Queue command). 

The Abort Acknowledge bit is used to stop aborting commands after this condition 
occurs. When a command completes with error, a typical response is for the host to re¬ 
issue the command that completed in error, with the Abort Acknowledge bit set Upon 
successful completion of the command, the host can then re-issue each command that 
was aborted because of the error. Th^ subsequent commands should not have the 
Abort Acknowledge bit set 

Btt 2 High Priority Command (HPC): 

The High Priority Command (HPC) bit flags a command so that the Jaguar places the 
command at the top of its work queue. If there are already other commands in the work 
queue with the HPC bit set, the new command is queued up directly behind the other 
High Priority Commands. (Thus, there is a RFO-type ordering of High Priority 
Commands.) 

Btt 3 Reserved (RSRV): 

This bit is reserved and must be cleared to 0 by the host. 
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Bit 4 Fetch Offboard (FOB): 

This bit is only used in applications involving offboard lOPBs. If this bit is set, then the 
corresponding lOPB will be fetched from the host memory. The only other bit in the 
Queue Entry Control Register that is valid when the FOB bit is set is the Go/Busy bit (Bit 
0 ). For a discussion of offboard lOPBs, refer to the section "Offboard lOPBs" in 
Chapter 6. 

Bits 5-7 (RSRV) Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bits 8-11 iOPB Type: 

These bits describe the IOPB type. The Jaguar supports only type zero lOPBs, so this 
field should be cleared to 0. 

Bits 12-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 

CQE WORD 1: 

For onboard lOPBs, Command Queue Entry Word 1 is used to store the IOPB Address. For 

uiiuuaiu ivrDd, ii iiuiud uws iiieiiiuiy uaiKHoi i.ypt’s aiiu auuiciSK» iiiuuiiit;i us»C9U uy iiw 

Jaguar to DMA the offboard IOPB into onboard memory. These two uses of the field are 
explained below. 

iOPB Address. For an onboard IOPB, Command Queue Entry Word 1 points to the location of 
the IOPB in short I/O. The value is specified as an offset from the short I/O base address. The 
Jaguar transfers both the Command Queue entry and the IOPB out of short I/O as soon as it 
"sees” that the Go/Busy bit is set 

MemorvTvDen'ransferTvDe/Address Modifier. For an offboard IOPB, Command Queue Entry 
Word 1 is used to specify the memory type, transfer type, and address modifier used to transfer 
the IOPB onboard. This field is identic^ in format and purpose to the Memory Type/Transfer 
Type/Address Modifier field in word 7 of the Printer Port IOPB. For a description of the field, 
refer to Chapter 5. 

CQE WORDS 2-3: 

For onboard lOPBs, Command Queue Entry Word 2 is used to store a host-assigned command 
tag. For offboard lOPBs, it holds the physical address of the offboard Command Queue 
entry/IOPB. These two uses of the field are explained below. 

Command Tag. For onboard lOPBs, Command Queue Entry Words 2-3 can be used to store 
a host-specified command tag. The Jaguar does not use or rnodify the value stored in this field. 
It simply returns the Command Tag as part of the Command Response. Thus, in a typical 
implementation, the host would use a unique value Command Tag for each Command Queue 
entry so that it can always differentiate one command from another. 
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Host Address. For offboard lOPBs, Command Queue Entry Words 2-3 are used to store the 
physical address of the offboard Command Queue entry and Its corresponding lOPB in host 
memory. Word 2 stores the most significant word (MSW) of the address, and Word 3 stores the 
LSW. 

CQE WORD 4: 

CQE Word 4 consists of a Work Queue Number field and an lOPB Length field. 




U I 13 I 12 I 11 10 I 9 a 7 I « I S I 4 3 I 2 1 0 


^Work Queue Nuaber 
♦Reserved 
♦lOPB Length 


Figure 3-11. lOPB Length/Work Queue Number 
Bits Q-3 Work Queue Number: 

This byte contains the number of the work queue Into which the command is to be 
placed. Since the Jaguar supports 15 work queues (14 device-specific queues plus Work 
Queue 0). valid entries in this field are 0x0 to OxE. 

NOTE 



Bits 4-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Bits 8-15 lOPB Length: 

The iOPB Length byte specifies the length of the lOPB to which the Command Queue 
entry is pointing. For onboard lOPBs, writing a V to this field indicates that the default 
len^ of the IOPB is being used. This field should only contain a non-zero value If 
the IOPB Involves a vendor-unique SCSI command (Group 6 or 7). Refer to the 
SCSI Pass-Through IOPB section for additional information. 

CQE WORD 5: 

CQE Word 5 is reserved for both onboard and offboard lOPBs. This field should be cleared to 
0 by the host 
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HOST USABLE SPACE (HUS) 

The Host Usable Space (HUS) is freeform memory space accessible to both the host and the controller. 
No partitioning of the HUS is implied or required by the Jaguar MACS! interface. The manner in which 
it is used is totally under the control of the host Typically, the HUS in the Jaguar is used to pass the 
iOPB portion of a command, in some multiprocessing af^ications, the HUS is a handy place to post 
semai^ores between CPUs. 

The amount of HUS available determined by two Actors: the number of Command Queue entries 
defined when the Command Queue is initialized, and by the length of the Command Response Block that 
is defined. For example, if the Command Queue is initialized with ten entries (each Command Queue 
entry is 12 bytes long) and a Command Response Block of 76 bytes is defined, there will be 1704 bytes 
of HUS available. The Master Controi/Status Block, Master Command Entry, and the Controiier Specific 
Space always occupy a total of 148 bytes. 

COMMAND RESPONSE BLOCK (CRB) 

The Command Response Block (CRB) is used by the Jaguar to post command completbn status. The 
IOPB itself and related status Information are returned to the Command Response Block. 

The CRB is also used to return an error status block in the event of a controiier interrupt (see Bit 7. 
Status Change, in the Command Response Status Word of the CRB). 

In addition, if enabled to do so. the Jaguar uses the CRB to signal the following conditions: 

• Space has become available in the Command Queue to accept new entries. (The 
Interrupt on Queue Available feature must be enabled.) 

• A printer status change has occurred. (Your setup must include a printer port daughter 
card and status change interrupts must be enabled). 

The CRB is made up of the Command Response Status Word (CRSW), the Command Tag, the Work 
Queue Number, and the Returned IOPB. 

The offset of the Command Response Block is defined at initialize time. The length of the Command 
Response Block can be determined by subtracting the Command Response Block offset from the offset 
of the Controller Specific Space (+0x788). However, the length of the Command Response Block must 
be equal to the largest IOPB defined plus 12 bytes. 
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Oftoet From Short I/O 
Base Address 

15 

14 

13 

12 

11 

10 

D 

8 

B 

6 

5 

4 

3 

2 

■ 

0 

+0X750 

(X)MMAND RESPONSE STATUS WORD 

+0X752 

RESERVED 

+0X754 

COMMAND TAG 

+0X756 

COMMAND TAG 

+0X756 

lOPB LENGTTH 

WORK QUEUE NUMBER 

+0X7SA 

RESERVED 

+0X75C 

To 

+0X787 

RETURNED iOPB 


NOTE: The above is the memofy map of the Commwid Response Block (CRB) if the CRB ofbet has been 
set to *O)(7S0 using the InitiaHze Controler command. Whh this setup, the maximum lOPB 
length is that of a SCSI Pass-Through lOPB used to issue a 12-byte SCSI command (i-e. maximum 
lOPB length > 44 bytes). 

Figure 3-12. Command Response Block (Sample Memory Map) 

COMMAND RESPONSE STATUS WORD (CRSW) 

The Command Response Status Word (CRSW) is the first word in the Command Response Block 
(CRB). It describes the nature of the Command Response. It also contains a Handshake bit and the 
Command Response Block Valid/Ctear Interrupt (CRBV) bit (The CRBV bit synchronizes the 
command interaction of the Jaguar and the host) The bits of the Command Response Status Word 
are defined as follows: 



14 1 13 

12 1 11 

10 

□□ 

□ 

□ODDaDD 


-- 1 >^<CRBV> 

-►(CO 

-►<ER) 

-►(EX) 

-►(AQ) 

-►(QMS) 

-►((»«() 

-►(SC) 

-►(RSRV) 

Figure 3-13. Command Response Status Word (CRSW) 

Bit 0 Command Response Block Valid/Clear Interrupt (CRBV): 

The Command Response Block Vaiid/Clear Interrupt {CRBV) bit is set by the Jaguar after 
it loads the returned lOPB, the Work Queue Number, and the Command Tag into the 
Command Response Block (CRB). 


The CRBV bit is also an Interrupt Pending bit because the Jaguar sets it immediately prior 
to issuing a Command Complete interrupt to the host. The Jaguar keeps the Command 
Response Block stable whBe this bit is set 
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After it is finished using the Informafion in the Command Response Biock, the host 
dears the interrupt by dearing the CRBV bit Once this bit is reset the Jaguar can use 
the Command Response Biock to present the next command response. 

Bit 1 Command Complete {CC^: 

The Command Compiete (CC) bit is set by the Jaguar when the Command Response 
Biock is being used to post the response to a Command Completion, as opposed to a 
Queue Entry Avaiiabie condition or a Start Queued Mode operation. The CC bit Is set 
even when the command is compieted with error or exception. (See Command 
Response Status Word (CRSW) bits 2 and 3.) 

Bit 2 Error (ER): 

The Error (ER) bit is set by the Jaguar when the Command Response Biock contains 
an iOPB that has completed with an error status. Examples of conditbns that may 
cause an IOPB to compiete with the Error bit set indude: 

• An incorrectly specified parameter which causes the Jaguar to 
misinterpret the command 

• An invalid address leading to bus errors or timeouts 

• A faulty device which causes a timeout 


The Error bit will also be set for Pass-Through commands that return any value other 
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The Error bit is valid only when Command Complete is active. 
Bit 3 Exception (EX): 


The Exception (EX) bit is set by the Jaguar when the Command Response Block 
contains an IOPB that has compieted with an exception. 


A command completed with exception is one which completed without error, but has 
some IOPB parameter that has not been completely satisfied. EXAMPLE: The Jaguar 
completes a Pass-Through SCSI command without transferring ail of the data specified 
in the lOPB's transfer count field. (For many SCSI commands, this is not an error 
condition, but rather something about which the host probably needs to be notified.) 

The Exception bit is valid only when Command Complete is active. 

Bit 4 Abort Queue (AQ): 

When work queues are initialized by the host, they can be set up (optionally) so that all 
of the commands in the queue can be aborted after a command completes with an 
error. (See Initialize Work Queue Command.) The command that was completed with 
an error is reported Just like any other error, with the Error bit set in the Command 
Response Status Word. 


With Abort on Error enabled, the Jaguar, on an error, will abort ail commands in the 
work queue. In addition, all commands in the Command Queue destined for that work 
queue will be aborted until a command with the Abort Acknowledge bit set in the Queue 
Entry Control Register is encountered. (See Queue Entry Control Register). Ail of the 
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aborted commaixls are reported in the Command Response Block with the Command 
Complete. Error, and Abort Queue bits set The Error interrupt Vector of the command 
being aborted wiil be used to report this condition. 

Bit 5 Queue Mode Started (QMS): 

The Queue Mode Started (QMS) bit is set by the Jaguar in response to the host setting 
the Start Queue Mode (SQM) bit in the Master Control Register. (See Master Control 
Register). 

Once the Command Queues and work queues have been initialized, the host starts 
Queued lOPB operation by setting the SQM bit in the Master Control Register. The 
Jaguar wNI acknowledge entering Queued lOPB mode by setting the Queue Mode 
Started bit in the Command Response Status Word. No interrupt will be generated. 

Bit 6 Command Queue Entry Avaiiabie (CQA): 

The Command Queue Entry Avaiiabie (CQA) bit is set by the Jaguar when the 
Command Response Block is presented in response to a queue entry avaiiabie 
condition. The CQA bit is mutually exclusive with the Command Complete bit. 

Bit 7 Status Change (SC): 

This bit is set to indicate one of the following conditions: 

• A printer status change has occurred. 

• A device has connected for which no iOPB exists (lOPB type error). 

• An IOPB has timed out 

• A device is requesting more data to be transferred than the IOPB 
allows. 

• A device is requesting a data transfer of the opposite direction specified 
by the lOPB's direction bit 

If Bit 7 is set the Jaguar wll return an error status block without returning the IOPB that 
caused the error. Refer to "Controller Error interrupt and Vector". Chapter 6 for details 
on this special case. 

Bits B-15 Reserved (RSRV): 

These bits are reserved and are cleared to 0 by the Jaguar. 

COMMAND TAG 

This Command Tag is the same 4-byte value that was provided in the Command Queue Entry 
when this command was originally issued to the Jaguar. The Jaguar does not use the Command 
Tag. nor does it modify it it simply returns the Command Tag as part of the Command 
Response. The Commaiid Tag is u^ by the host to determine to which command the Jaguar 
is responding. 
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lOPB LENGTH WORK QUEUE NUMBER 

The lower byte of this word specifies the number of the work queue to which the command was 
issued. The upper byte specifies the iength of the returned lOPB. A length of zero indicates the 
lOPB is the defauit iength. The entire lOPB Length/Work Queue Number word is returned from 
the Command Queue entry exactly as it was originally entered by the host. 

RETURNED lOPB 

The Returned lOPB field of the Command Response Block is usually an image of the lOPB that 
was passed with the Command Queue Entry when the command was originally issued to the 
Jaguar. In some cases, depending upon the specific lOPB, some of the parameters are modified 
to reflect Command Com^etion status. 

This returned lOPB area is undefined for a response to a Queue Entry Available condition or for 
any other command response where the original command did not require an lOPB. 

CONTROLLER SPECIFIC SPACE 

The Jaguar uses the 120-byte Controller Specific Space to post the Configuration Status Block. This 
space begins at an off^ of +0x788 from the short I/O base address. 

CONFIGURATION STATUS BLOCK 

Tne Jaguar uses the Configuration Status Block to report its current configuration. This includes 
such information as the board's firmware revision level, product number and variations, available 
buffer space, and the SCSI bus IDs that it Is using. The format of the Configuration Status Block 
is shown below: 
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Figure 3-14. Ccxifiguration Status Block 

The following is a description of the values found In the Configuration Status Block. 

Product Code (3 bytes): 

These three bytes are the Interphase product code. This value is represented as a 3- 
character ASCII string. The most significant character appears first, it is valid after the 
completion of a controller reset 
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Product Variation (1 byte): 

This byte is the Interphase product variation code. This value is represented as one 
ASCII character. This value is valid after the completion of a controlier reset 

Rrmware Revision Levei (3 bytes): 

These three bytes are the revision level of the installed firmware. This value is 
represented as a 3-character ASCII string. The most significant character appears first. 
This value is valid after the completion of a controlier reset 

Rrmware Release Date (8 bytes): 

These 8 bytes are the release date of the installed firmware. This value is represented 
as an 8-character ASCII string. The format is MMDDYYYY. For example, a release date 
of January 15,1989 would be 01151989. It is valid after the completion of a controller 
reset 

Size of Buffer (2 bytes): 

These 2 bytes are the amount of on-board buffer RAM expressed in IK increments. This 
value is represented as a four-digit hexadecimal number. For example, a 128K RAM 
buffer would be 0080. This value is valid after the completion of a controller reset 

Primary SCSI Sue ID #1 Kulali' 

--# — ---- — 

This byte is the current bus ID for the primary SCSI bus. This value is represented as 
a 1-digit hexadecimal number. This value wM default to the bus ID encoded in the on¬ 
board switches at the completion of a controlier reset. This value will be updated at the 
completion of an Initialize Controller command. 

Secondary SCSI Bus ID (1 byte): 

This 1-digit hexadecimal value is the current bus ID for the secondary SCSI bus. It 
defaults to the bus ID encoded in the Jumpers on the SCSI daughter card at the 
completion of an Initialize Controller commarid. (For detals on these jumpers, refer to 
Chapter 2.) 

Last Primary Device Selected (1 byte): 

This byte contains the SCSI ID of the last primary SCSI bus device selected by the 
Jaguar. This field is updated every time the Jaguar selects or reselects a device on Port 
0 . 


Last Secondary Device Selected (1 byte): 

This byte contains the SCSI ID of the last secondary bus device selected by the Jaguar. 
This fW is updated every time the Jaguar selects or reselects a device on Port 1. 
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Primaiy Phase Sense (1 byte): 

This byte contains the status of the primary SCSi bus. The primary phase sense register 
contains a copy of Port O's Fujitsu 87030 phase sense register. This copy is updated 
approximately every 27 to SSmsec. The signals in the register are shown below; 


Request -^J 
Acknouledge^— 
Attention - 
Select <— 


I 07 D6 I D5~ D4 I D3 I D2 I D1 [ 


DO 


I—Input/Output 
—»^Control/Data 


■^Message 
■^Busy 


Figure 3-15. SCSI Bus Status Byte 

Each of the above bits corresporxJs to a signal on the SCSI bus. If the bit is set. the 
corresponding SCSi signal is active. The meaning of the signals is as follows: 

Table 3-2. Meaning Of SCSI Signals In 87030 Phase Sense Register 


SIGNAL 

NAME 

DESCRIPTION 

H 

REQ 

Request 

The controller asserts REQ to start an asynchronous bus transfer. 

ACK 

Acknowiec^ 

The target asserts ACK to Indtoale that It has sent (or received) 
data. This signal is used in tandem with REQ to handie ail 
asynchronous data transfers 

ATN 

Attention 

The target asserts ATN to tsN the initiator that there is a 
message vraiting for IL 

SEL 

Select 

The initiator asserts SEL to fodicate whk^ target is to perform an 
lyrooming operation. The ID of the target is simultaneousiy sent 
over the data Ines. The 4210 asserts SEL to reconnect during the 
Reseiection phase. 

BSY 

Busy 

This signal is driven by the initiator or target using the bus to 
indicatB that the bus is busy. 



The oontroler drives this signal when it is transferring a message 
(as opposed to data). 

C/D 

Control/Data 

The oontroler uses this signal to indicate the type of information on 
the bus (asserted « command/message, negated > data). 

I/O 

Input/Output 

The oontroler drives this signal to control the direclion in which 
data is moving on the bus (asserted ■ targ^-to-initiator transfer, 
negated «initiator-to-target transfer). 


For a complete description of the signals, please refer to the SCSI specification or the 87030 
user's guide. 

Secondary Phase Sense/Printer Status (1 byte): 

If your board has a SCSI daughter card, this byte shows the status of the secondary SCSI bus 
status. If you are using a printer port daughter card, the byte shows the status of the printer, 
if the former is the case, the byte is an image of the ports Fujitsu 87030 phase sense register. 
The format of this register is shown in the preceding figure. This copy is updated approximately 
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every 27 to 35msec. This register is identical in operation to the primary SCSI port register 
above. 


If the printer port is installed, this register contains the printer status. This register will be updated 
at the completion of any print command or approximately every 27 to 35msec. The bit definition 
of this register is dependent on whether the interlace is Dataproducts or Centronics type. The 
format of that register is as follows: 


Meaning of Register for Dataproducts Printer: 



1 1 

D5 1 D4 1 D3 

LEj 

0 

DO 1 


READY 

-ONLINE 

-PARITY ERROR 

-CABLE ON 

-BOTTOM OF FORM 

-► TOP OF FORM 

-PAPER MOVEMENT 

—^ CONFIGURATION JUMPER M's DATAPRODUCTS 


Meaning of Register for Centronics Printer: 


D7 

D6 

D5 

D4 

D3 1 02 

0 

1 1 


♦ FAULT 

♦ SELECT 

♦ PAPER EMPTY 

^ RESERVED MAY BE 'O' OR '1' 

♦ RESERVED MAY BE 'O' OR '1' 

^ RESERVED MAY BE 'O' OR '1' 

♦ BUSY 

CONFIGURATION JUMPER 'O' = CENTRONICS 


Figure 3-16. Printer Status Register 


Daughter Card ID (1 byte): 


The daughter card ID field contains a value from 0x0 to 0x7 that indicates the type of daughter 
board installed (if any). The meaning of the codes is as follows: 

Table 3-3. Daughter Card ID 


CODE 

NEANIHG 

0x7 

No daughter card is installed 

0x6 

SCSI daughter card 

0x5 

(reserved) 

0x4 

Printer daughter card 

0x3 

(reserved) 

0x2 

(reserved) 

0x1 

(reserved) 

0x0 

(reserved) 
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Software DIP Switch (1 byte): 


This field reports the status of features set using Switch Block SW2. This switch block is only 
provided on Jaguars with the board layout shown in Chapter 2. Boards that do not have the 
switch wll report the value of a location in the firmware that performs the same function. The 
following functions are presently defined: 


0 > Reset SCSI bus on power-up 
1 • Do not reset SCSI bus on power-up 
0 - Execute nonssl power-up test; 

deer SYSFAIL* before test 
1 - Execute extended power-up test; 
deer SYSFAIL* efter passing test 

Reserved 


Figure 3-17. Software Configuration Switch Settings Reported In Configuration Status Block 


Frozen Work Queues (2 bytes): 


This register provides Work Queue frozen status for the Jaguar's 14 Work Queue's, 0-14. The 
Jaguar wBI set a 1 in the Work Queue's bit position if the queue is frozen. The format of the 
register is as follows: 


WORK QUEUE 0 
UORIC QUEUE 1 
WORK QUEUE 2 
WORK QUEUE 3 
WORK QUEUE 4 
WORK QUEUE 5 
WORK QUEUE 6 
WORK QUEUE 7 
WORK QUEUE 8 
WORK QUEUE 9 
WORK QUEUE 10 
UORIC QUEUE 11 
UORIC QUEUE 12 
UORIC QUEUE 13 
UORIC QUEUE 14 
RESERVED 

NOTE: Uork Queue 0 cannot be frozen; therefore, Bit 0 is always cleared. 


Figure 3-18. Frozen Work Queues Register 
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CHAPTER 4 
VMEbus INTERRUPTS 


OVERVIEW 

At the completion of a command (either successful or terminated with an error or with an exception), the 
Jaguar notifies the host by generating a Command Complete Interrupt on the VMEbus. The Jaguar can 
respond to the VMEbus Interrupt Acknowledge Cycle with different interrupt Vectors based on the cause 
of the interrupt. But for those VMEbus systems that allow only one interrupt vector per device, the host 
can still determine the source of the interrupt by checking the status bits in the Command Response 
Status Word and the Work Queue Number foufxj in the Command Response Block. 

The hardware driving the VMEbus interrupt line is cleared at the completion of the VMEbus Interrupt 
Acknowledge Cycle. However, a Clear Interrupt operatbn must also be executed by the host to notify 
the Jaguar that the interrupt has been properly serviced by the host and that the Jaguar may now post 
its next interrupt The host does this by clearing the CRBV bit in the Command Response Block. (See 
the Command Response Status Word in the Command Response Block, Chapter 3). 


NOTE 



4-1 














INTERPHASE CORPORATION 


THIS PAGE LEFT INTENTIONALLY BLANK 


4-2 







lOPBs AND COMMANDS 


CHAPTER 5 

I/O PARAMETER BLOCKS AND COMMANDS 


OVERVIEW 

The MACSI software interface of the Jaguar can handle two distinct types of lOPBs: SCSI lOPBs and Control 
ICPBs. SCSI lOPBs are commands that are sent to either the attached SCSI devices or to the printer port 
(If used). Control lOPBs are commands for the Jaguar Itself (such as an initialization command) that result 
in local Jaguar action only. 


Table 5-1. Jaguar Command Set 


SCSI lOPBs 

COMMAND CODE 

SCSI Pass-Through 

(0x20) 

SCSI Reset 

(0X22) 

Printer Port 

(0x23) 

CONTROL lOPBs 

COMMAND CODE 

Perfoim Diagnostics 

(0X40) 

Initialize Controller 

(0X41) 

InitiaRze Work Queue 

(0X42) 

Dump Initialization Parameters 

(0X43) 

Dump Work Queue Parameters 

(0x44) 

Bus Status Inquiry 

(0x45) 

Command Status Inquiry 

(0x46) 

Cancel Command Tag 

(0X48) 

Flush Work Queue 

(0X48) 

InitiaKze Printer Port 

(0x4A) 

Restart Controller 

(0X4B) 

Device Reinitializa 

(0X4C) 

Issue Bus Device Reset Message 

(0X4D) 

Issue Abort Message 

(0X4E) 


In general, SCSI lOPBs are issued to a specific device via its assigned work queue (Work Queue 1 -14). 
Each work queue must be separately initialized before commands can be issued to it. Control lOPBs must 
be issued through the Master Command Entry to Work Queue 0. 
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NOTE 

Tfast^ SCSI Rcs«t cQitQ&dttd can Im» ksnx^ la dte a ^i^ciEic tfavio^ or tiie 

MMtir Coowkaad Bnity* Rdler to tike C(!>ma{^ 


VMEbus ADDRESS MODIFIERS 

As a slave, the Jaguar responds to either: 1) 0x2D and 0x29, or 2) 0x2D only. This depends on 
how Switch 9 in Switch Block SW1 is set on your motherboard. As a master, the Jaguar will use 
whatever address modifier is in the lOPB. It is not checked. 

SCSI PASS-THROUGH (0x20) 

The SCSI Pass-Through lOPB provides all of the information the Jaguar needs to send a command to 
a specific SCSI peripheral on either of the SCSI buses. The lOPB's size can be adjusted to accommodate 
different SCSI command lengths. 

The figure below shows the format of the SCSI Pass-Through lOPB when used to issue a 12-byte SCSI 
command. 
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word# 

1 1 1 1 1 1 1 ! ! j 1 

15 1 14 1 13 1 12 1 11 1 10 1 9 1 8 { 7 1 6 1 5 1 4 3 2 1 0 

0x0 

COMMAND CODE (0x20) 

0x1 

COMMAND OPTIONS 

0x2 

RETURN STATUS 

0x3 

RESERVED 

0x4 

NORMAL COMPLETION VECTOR 

ERROR COMPLETION VECTOR f 

0x5 

INTERRUPT LEVEL 

0X6 

RESERVED 

0x7 

UNK ! RESERVED j TT j MT 

ADDRESS MODIFIER || 

0X8 

BUFFER ADDRESS 
(Or Scatter/Gather List Address *) 

0x9 

OxA 

MAXIMUM TRANSFER LENGTH 
(Or Scatter/Gather element Count *) 

OxB 

OxC 

RESERVED 

(Or Scattor/Gather Totai Transfer length *) 

OxD 

OxE 

RESERVED 

OxF 

ilMIT A!MM3COe 

r-iwrik»ww 

0X10 

SCSI BYTE 0 

SCSI BYTE 1 

0X11 

SCSI BYTE 2 

SCSI BYTE 3 

0X12 

SCSI BYTE 4 

SCSI BYTE 5 

0X13 

SCSI BYTES 

SCSI BYTE 7 

0X14 

SCSI BYTES 

SCSI BYTE 9 

0X15 

SCSI BYTE 10 

SCSI BYTE 11 


* Scatter/gather operations only. 


NOTES: Fields set in bold capiurf letters are returned values. 
AH other values are host provided. Reserved fields 
must be cleared to 0 by the host 


Figure 5-1. SCSI Pass-Through lOPB For 12-Byte SCSI Command 


The size of the SCSI Pass-Through lOPB can be adjusted to accomnKxiate different SCSI command 
lengths. For example, to issue a 12-byte SCSI command, append the 12-byte Command Descriptor Block 
starting at word 0x10 of the lOPB. 

To determine the length of the SCSI command, the Jaguar examines the Group Code field in Byte 0 of 
the Command Descriptor Block (CDB). The possible entries in this field are as follows: 
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Table 5-2. Group Codes For SCSI Commands 


GROUP 

COB LENGTH 

0 

6 Bytee 

1 

10 Bytes 

2 

(Reserved) 

3 

(Reserved) 

4 

(Reserved) 

5 

12 Bytes 

6 

User Defined 

7 

user Defined | 


If the command is a Group 0,1, or 5 SCSI command, the Jaguar will'' knowThe length of the Command 
Descriptor Block (6. 10, or 12 bytes, respectively). In these cases, dear the lOPB Length field of the 
corresix>nding Command Queue entry to ' '0". 

If issuing a user-defined SCSI command (Group 6 or 7), you must tell the Jaguar how long the command 
is. This is done by filling in the lOPB Ler^h fi^ of the corresponding Command Queue entry with the 
number of words in the iOPB. The Jaguar wiii then calculate the Command Descriptor Biock iength by 
subtracting the overhead of the IOPB (0x10 words) from the iength specified in the Command Queue 
entry. 

The remainder of this section describes the function of each field in the SCSI Pass-Through IOPB. 

HOST-PROVIDED IOPB FIELDS 


The following information must be provided in the IOPB for the SCSI Pass-Through command: 

COMMAND CODE (2 BYTES) 


This field must be set to 0x20 to execute the SCSI Pass-Through command. 

COMMAND OPTIONS (2 BYTES) 


This field contains the options for this command. The bits are defined as follows: 



B 

B 

B 

B 

1 10 1 9 1 

□ 

□ 

MiJ 

□ 




- 1 I -1 INTERRUPT ENABLE 

-►SCATTER/GATHER 

-»'SUPPRESS SYNCHRONOUS TRANSFERS 

-►RESERVED 

-►TRANSFER DIRECTION 

I-►RESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Comf^ete interrupt. 
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Bit 1 Scatter/Gather (SG): 

This bit should only be set if the command involves a scatter/gather operation. When 
scatter/gather Is enabled, the following fields are defined differently than for non¬ 
scatter/gather: Address Modifier/MemoryType/TransferType, Buffer Address, Maximum 
Transfer Length, and the Reserved field at Words OxC - OxD. For a detailed discussion, 
please refer to "Scatter/GatherOperations,”. 

Bit 2 Suppress Synchronous Transfers (SS): 

Setting this bit in the first passthrough command sent to a device causes the Jaguar 
to disable synchronous transfers with that device. The Jaguar must be reset to re-enable 
synchronous transfers with that device. This bit is provided as a work around in the 
event a device does not process the synchronous transfer request message correctiy. 
Thus, the bit should be deared for normal operations. 

Bits 3-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 8 VMEbus Transfer Direction (DIR): 

This bit specifies the direction of the data transfer over the VMEbus, as follows: 


BITS 

VMEbus DIRECTION | 

0 

Write dato to the VMEbus | 

m 

Read data from the VMEbus | 


Bits 9-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 


15 


14 


13 I 12 


q: 

JL 

9 

I 

I 

I 

5 U 

I 

I 

1 

3 


TERROR COHPLETION VECTOR 
^NORMAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completbn with error. 


5-5 
















INTERPHASE CORPORATION 


Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 


FFl 

I] 

□ 

iiiiJ 

I] 

□ 


•-►INTERRUPT LEVEL 

-»^RESERVED 


Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

ADDRESS MODIFIER/MEMORY TYPE TRANSFER TYPE (2 BYTES) 

These bytes specify the address modifier, memory type, and transfer type to be used 
for ail VMEbus transfers associated with the command. 

NOTE 



Bits 0-7 Address Modifier: 

This byte specifies the address modifier to be used by the Jaguar for all VMEbus data 
transfers associated with this command. 
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Bits 8-^ Memory Type (MT): 

This 2-bit field specifies the width of data transfers. Permitted values are as follows; 
Table 5-3. Memory Type For SCSI Pass-Through Command 


BITS 

BITS 

MEMORY TYPE | 

0 

0 

1 

(RESERVED) I 

0 

1 

16 -Brr TRANSFERS 

1 

0 

32-Brr TRANSFERS 

1 

1 

SCATTER/GATHER UST RESIDES IN SHORT MO* j 


* Valid only for Scatter/Gather operations 


Bits 18-11 Transfer Type (TT): 

This 2-blt field specifies the type of data transfer to be performed. Permitted values are 
as follows: 

Table 5-4. Transfer Type for SCSI Pass-Through Command 


BITH 

BITIO 

TRANSFER TYPE 

0 

0 

NORMAL TYPE 

0 

1 

BLOCK MODE 

1 

0 

(RESERVED) 

1 

1 

(RESERVED) 


Bits 12-14 Reserved (RSRV): 

These bits are resenred and must be cleared to 0 by the host. 

Bit 15 Unk (LNK): 

This bit should only be set if you are linking scatter/gather lists. Refer to 
"Scatter/GatherList Linking,”. 

BUFFER ADDRESS (4 BYTES) 

This field specifies the address at which the Jaguar will begin the data transfer. If the 
Jaguar is addressing system memory, the value in the field is a VMEbus address. If the 
address is in short I/O, the value is an offset from the Jaguar's short I/O base address. 
If scatter/gather is enabled, this field is the address of the scatter/gather list. 
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15 


nr 

Z 

JL 

z 

Jl. 

□ 

□ 

D 

□Q 

□ 

□ 

□ 

ni 


MSU 


LSU 


BUFFER ADDRESS 

(Or Address Of Scatter/Gather List) 


MAXIMUM TRANSFER LENGTH (4 BYTES) 

This field specifies the maximum number of bytes that may be transferred by the 
command. If no data is to be transferred, a Transfer Length of zero should be specified. 
When scatter/gather is enabled, this field contains the number of scatter/gather 
elements. 


1 « M* 

JL 


E 


□B 

□B 

BBB 

B 

B 


NSU 


- MAXIMUM TRANSFER LENGTH 

LSU (Or Scatter/Gather Element Count) 


RESERVED (4 BYTES) 

Unless scatter/gather is enabled, words OxC and OxD of the SCSI Pass-Through lOPB 
are reserved and must be cleared by the host For scatter/gather operations, this field 
specifies the sum of the individi^ element entry counts. See "Scatter/Gather 
Operations." for details. 

UNIT ADDRESS (2 BYTES) 

This field specifies the SCSI bus and the address of the targ^ device. 


15 1 U 1 13 1 12 

z 

Jl. 

I 

8 

I 

I 

I 

I 

ilL 

I 

z 


-»>SCSI DEVICE ID 
^LOGICAL UNIT NUMBER 
-^SCSI BUS SELECTION 
-»>RESERVE0 


Bite 0-2 SCSI Device ID (SCSI ID): 

These three bits are the SCSI Bus ID (SCSI ID) of the specified device. 

Bits 3-5 Logical Unit Number (LUN): 

These bits describe the SCSI Logical Unit Number (LUN) of the specified device. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the Jaguar uses 
when executing the command. When the BUS bit is cleared to 0, the Jaguar executes 
the (xxnmand over the primary SCSI bus (Port 0). When set to 1, it uses the secondary 
SCSI bus (Port 1). 
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Bits 7-15 Reserved: 

These bits are reserved arxl must be cleared to 0 by the host. 

SCSI COMMAND BYTES 

The SCSI CommarKi Bytes specify the bytes that the Jaguar passes unchanged across 
the SCSI bus to the selected SCSI device. As discussed at the beginning of this section, 
the Jaguar determines the length of the Command Descriptor Block by looking at the 
group code in SCSI Byte 0 of the iOPB. 

As noted previously, the length of vendor-unique SCSI commands (Group 6 or 7) must 
be specified in the IOPB Length field of the corresponding Command Queue entry. The 
Jaguar calculates the Command Descriptor Block length by subtracting the overhead 
of the IOPB (0x10 words) from the length specified in the Command Queue entry. 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
IOPB for the SCSI Pass-Through command. 

RETURN STATUS (2 BYTES) 

This field provides the return status for the command. 


E 

1 13 1 12 1 

E 

10 

□ 

8 

□ 

6 

5 

□ 

3 

3 

2 

1 

0 


TERROR CODE 
«>PASS-BASrATUS 


Bits 0-7 Error Code: 

The Error Code byte describes the status of the controller at the end of the command 
response. Any non-zero value is an error code. A list of Jaguar error codes is provided 
in Appendix C. 

Bits 8-15 Pass-Back Status: 

This value is the SCSI status byte returned by the target device. It is not changed by 
the Jaguar. 


5-9 








INTERPHASE CORPORATION 


SCSI RESET (0x22) 


The SCSI Reset lOPB instructs the Jaguar to reset the SCSI bus identified by the command. It terminates 
all pending commands on the SCSI bus. A Command Complete with Error will be issued for each 
command terminated as a result of the SCSI Reset command. 

NOTE 


It may be m»cemty lar dm liesr m Smm to de^ikcs after 

esecutlagdie SCSIlteset ec»mxaBd.Tiiii&di[^peB4s'9&^^^ reiplre after 

a SCSI reset, Cmmult yeur dev^ ixtaffifals far 


When the host issues a Reset SCSI Bus lOPB through the Master Command Entry, all work queues with 
commands active on the specified SCSI bus will have those commands returned with a SCSI reset error 
status, in addition, the work queues corresponding to those commands will be frozen if the Freeze Work 
Queue on Reset option is enabled. (This option is enabled when the Jaguar is initialized. For details, 
see the Error Recovery Flags field in the Controiier initialization Block.) 

Normally, this command is used only in an to attempt to recover from an unusual error condition. 


Word* 

BDQMDIiiili 

BUEilBEiEl^lDi 

0x0 

COMMAND CODE (0x22) 

0x1 

COMMAND OPTIONS 

0x2 

RETURN STATUS 

0x3 

(RESERVED) 

0x4 

NORMAL COMPLETION VECTOR 

ERROR COMPLETION VECTOR f 

OxS 

INTERRUPT LEVEL 

0x6 

To 

Oxd 

(RESERVED) 

OxE 

SCSI BUS ID 


NOTE' Reserved fields must be set to 0 by the host 


Figure 5-2. SCSI RESET lOPB 

The following section describes the function of each field in the SCSI Reset iOPB. 

HOST-PROVIDED IOPB FIELDS 

The following information must be provided in the IOPB for the SCSI Reset command: 
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COMMAND CODE (2 BYTES) 

% # 

This field must be set to 0x22 to execute the SCSI Reset command. 

COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 


Ql 

JL 

_12. 

I 

I 

I 

I 

I 

I 

I 

I 

[I 

3 


J l^lnterrupt Enable 
-^^Reserved 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Com^^ete interrupt. 

Bits 1-15 Reserved: 


These bits are reserved and must be cleared to 0 by the host. 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 


These two bytes specify the VMEi^ intemj^ vectors thai the Jaguar will use to report 

normal command completion and command completion with error. 



B 

B 

B 

B 


□ 

□ 



□ 

□ 

S 

hi ’ 1 

0 


>ERR0R COHPLETION VECTOR 
^NORMAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 


15 1 U 1 13 

B 

ME 

9 

Liid 

□ 

hM 

a 

□ 

□ 



TERROR COMPLETION VECTOR 
>N0RMAL COMPLETION VECTOR 
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Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt levei used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 Is allowed 
only when Interrupts are disabled (Interrupt Enable bit = 0 In the Command Options 
wo^). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

SCSI BUS ID (2 BYTES) 

This field identifies which bus is to be reset 


15 1 14 1 13 1 12 1 11 


□ 

| 8 | 7 | 6 | 

□ 

□ 


□ 

□ 

□ 


L . . . , „ ... I 


PRESERVED 

>SCSI Bus Selection (BUS) 


Bits 0-14 Reserved: 

These bits are reserved and must be cleared to 0. 

BH 15 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the Jaguar uses 
when executing the command. When the BUS bit is cleared to 0. the Jaguar executes 
the command over the primary SCSI bus (Port 0). When set to 1, it uses the secondary 
SCSI bus (Port 1). 

RETURNED VALUES 

Upon command completion, the foiiowing information is provided by the Jaguar in the returned 
lOPB for the SCSI Reset command: 


RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in App^ix C. 
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PRINTER PORT lOPB (0x23) 

This command is used to issue instructions to a printer connected to the Jaguar's printer port. Before 
issuing a Printer Port iOPB, the host must initialize the port using the Initialize Printer Port command. 

For additbnal information on the printer port, please refer to Chapter 6. 

The format of the Printer Port IOPB is as follows: 



NOTES: Reids set in bold capital tetters atB returned values. 

Al other values are host provided. Reserved fields 
must be cleared to 0 by the host 

Figure 5-3. Printer Port IOPB 

The remainder of this section describes the function of each field in the Printer Port IOPB. 

HOST-PROVIDED IOPB FIELDS 

The following information must be provided in the IOPB for the Printer Port command: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x23 to execute the Printer Port command. 
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COMMAND OPTIONS (2 BYTES) 


This field contains the options for this command. The bits are defined as follows: 


15 1 14 1 13 


Qi] 

10 9 

□ 

7|0|5|* 

□ 

E 

□ 

□ 


J INTERRUPT ENABLE 

-►RESERVED 

-►PAPER INSTRUCTION 

-►RESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bite 1-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bn 8 Paper Instruction (PI): 

Setting the Paper instruction bit causes the Jaguar to transfer aii of the data specified 
in this lOPB to the printer with the Paper Instruction interface signal active. The Paper 
Instruction signal is only supported by Dataproducts printers. 

Bits ^15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR (2 
BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

I 15 I 14 I 13 I 12 I 11 I 10 I 9 I 8 I 7 I 6 I 5 I 4 I 3 I 2 I 1 I 0 I 

i ►ERROR COMPLETION VECTOR 

-►NORMAL COMPLETION VECTOR 


BHs 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 
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INTERRUPT LEVEL (2 BYTES) 

... %“■ — - -- g 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 



E 

E 

E 

E 

E 

m 

0 

m 

0 

0 

0 

0 

0 

0 

0 

1 

... . 1 [. 


INTERRUPT LEVEL 
-PRESERVED 


Bits 0-2 interrupt Levei (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

ADDRESS MODIFIER/MEMORY TYPE/TRANSFER TYPE (2 BYTES) 

These bytes specify the address modifier, memory type, and transfer type to be used 
for all VMEbus trarisfers associated with the command. 



Bits 0-7 Address Modifier: 

This byte specifies the address modifier to be used by the Jaguar for ail VMEbus data 
transfers associated with this command. 

Bits 8-9 Memory Type (MT): 

This 2-bit field specifies the width of data transfers. Permitted values are as follows: 
Table 5-5. Memory Type For Printer Port Command 


1 

errs 

MEMORYTYPE 

1 0 

0 

RESERVED 

1 0 

1 

16 -Brr TRANSFERS 

1 

0 

32-Brr TRANSFERS 

1 

1 

RESERVED 
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Bits 10-11 Transfer Type (TT): 

This 2-bit fieid specifies the type of data transfer to be performed. Permitted values are 
as follows: 


Table 5-6. Transfer Type For Printer Port Command 


errn 

BITIO 

TRANSFERTVre I 

0 

0 

NORMAL MODE I 

0 

1 

BLOCK MODE I 

1 

0 

RESERVED I 

1 

1 

RESERVED | 


Bits 12-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 

BUFFER ADDRESS (4 BYTES) 

This field specifies the address In system memory at which the Jaguar will begin the 
data transfer. 



MAXIMUM TRANSFER LENGTH (4 BYTES) 

This field specifies the maximum number of bytes that may be transferred by the 
command. 



The Jaguar must perform either word (16 bit) or long word (32 bit) transfers across the 
VMEbus. Therefore, the Maximum Transfer Length field cannot contain an odd number 
of bytes. It must be rounded up to the nearest word or long word boundary, depending 
on the size specified in the Memory Type field. 

Entering a length of zero in both the Maximum Transfer Length field and in the Printer 
Transfer Length field causes the Jaguar to return the iOPB with the current printer 
status. 
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PRINTER TRANSFER LENGTH (4 BYTES) 

Since the Jaguar can not transfer odd-byte^ength data across the VMEbus, the Printer 
Transfer Length fieid is used to specify the exact number of bytes to be transferred to 
printer. 



The above field must contain the exact count of bytes to be sent to the printer and must 
be fSled in on each lOPB. 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
lOPB for the Printer Port command: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is prosHded in Appendbc 0. 
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PRINTER STATUS (1 BYTE) 

This field contains the state of the printer status control lines at the completion of the 
data transfer. Only those lines which were enabled when the printer port was initialized 
will be reported (Refer "Status Change Interrupt Enable”). The definition of the bits in 
this field vary depending on the printer type, as listed below. 

Table 5-7. Definition Of Printer Status Bits 
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RETURNED VALUES FOR PRINTER STATUS CHANGE INTERRUPT 

If status change interrupts were enabled when the printer port was initialized, the following takes 
place when a status change occurs. The Jaguar generates an interrupt and posts the 
information shown below to the CommarKi Response Block. 



The Status Change bit (Bit 7) in the Command Response Status Word is set, and an image of 
the printer’s status lines is returned. The bits in the Printer Status field have the same definition 
as in the Printer Status field in the Printer Port lOPB (see above). The value in the Return Code 
field should be 0x90 (Printer Status Change). 


NOTE 
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PERFORM DIAGNOSTICS (0x40) 

The Perform Diagrx)stics command causes the Jaguar to perform a set of pass/fall seif-diagnostic tests 
that are more extensive than those performed during the power-up seif test These seif-diagnostic tests 
indude an extensive RAM test (scratchpad, buffer, and event RAM). Ali of the tests are performed, and 
then the status of each test is reported back in the Command Response Biock. Due to the nature of 
these tests, the Perform Diagnostics command cannot be executed whBe the Jaguar is operating. The 
Jaguar returns an error if this command is issued while ANY other command is queued. 

Since it takes 15-20 seconds for the Jaguar to complete such a thorough seif-diagnostic routine (and 
due to the relative completeness of the power-up seif tests), this command probably should not be used 
as part of the normal initialization routine in a system driver. 

The Perform Diagnostics command must be issued through the Master Command Entry to Work Queue 

0 . 

After executing this command, it is necessary to reset the 4210 before issuing additional commands to 
it. 



NOTES: 

Fields set in bold capital letters are returned values. 

Al other values are host provided. Reserved fields 
must be deared to 0 by the host 

Figure 5-5. Perform Diagnostics lOPB 

The remainder of this section describes the function of each field in the Perform Diagnostics lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Perform Diagnostics command; 

COMMAND CODE (2 BYTES) 

This field must be set to 0x40 to execute the Perform Diagnostics command. 
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RETURNED VALUES 

Upon command completion, the following Information is provided by the Jaguar in the returned 
iOPB for the Perform Diagnostics command: 

ROM TEST RESULT (2 BYTES) 

These bytes return the status of the ROM Test A test result of OxFFFF indicates that the 
test completed successfully. Any other value indicates that the test failed. 

SCRATCHPAD RAM TEST RESULT (2 BYTES) 

These bytes return the status of the Scratchpad RAM Test A test result of OxFFFF 
indicates that the test completed successfully. Any other value indicates that the test 
faHed. 

BUFFER RAM TEST RESULT (2 BYTES) 

These bytes return the status of the Buffer RAM Test. A test result of OxFFFF indicates 
that the test completed successfully. Any other value indicates that the test failed. 

EVENT RAM TEST RESULT (2 BYTES) 

These bytes return the status of the Event RAM Test A test result of OxFFFF indicates 
that the test completed successfully. Any other value indicates that the test failed. 

PRIMARY SCSI PORT REGISTER TEST (2 BYTES) 

These bytes return the status of the Primary SCSI Port Register Test. A test result of 
OxFFFF indicates that the test completed successfully. Any other value indicates that 
the test failed. 

SCSI SECONDARY PORT REGISTER TEST (2 BYTES) 

These bytes return the status of the SCSI Secondary Port Register Test. A test result of 
OxFFFF indicates that the test completed successfully. Any other value indicates that 
the test failed. 
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INITIALIZE CONTROLLER (0x41) 

The Initialize Controller command configures the Jaguar for use In a particular system. The host must 
Issue this command before the Jaguar can engage in any activity on the SCSI bus. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB for the Initialize Controller command Is: 



NOTES: 

Rekte set in bold capital letters are returned values. 

Al other values are host provided. Reserved fields 
must be cleared to 0 by the host 

Figure 5^. Initialize Controiier lOPB 

The remainder of this section describes the function of each field in the initialize Controller iOPB. 

HOST-PROVIDED iOPB FIELDS 

The following information must be provided in the IOPB for the initialize Controller command: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x41 to execute the Initialize Controiier command. 

COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 
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I -' " ' ^ l^IMTERRUPT ENABLE 

I-♦RESERVED 

BH 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Comf^ete interrupt. 

Bite 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 



nri 


Mi] 

B 


□ 

□ 

□ 

E 

□ 

□ 




El 


♦ERROR COMPLETION VECTOR 
♦NORMAL COMPLETION VECTOR 


■11VI WVII 


ll|^IVUVII VWWIi 


This value specifies the interrupt vector used when notifying the host of command 
completion with error. 


NornnsI Coinplotioii Vocton 


This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 


INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 


B 

JL 

z 


ji. 


I 

I 

I 

E 

5 

4 

"h 

Z 

z 


♦INTERRUPT LEVEL 
♦RESERVED 


Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 
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Bitt 3-15 Reserved: 


These bits are reserved and must be cleared to 0 by the host. 

ADDRESS MODIFIER/MEMORY TYPE TRANSFER TYPE 
(2 BYTES) 


These bytes specify the address modifier, memory type, and transfer type to be used 
for all VMEbus trarisfers associated with ^ command. 


Fn« 

9 « 

I 

I 

3 


m 


«>ADDRESS MODIFIER 
♦^lEMORY TYPE 
♦TRANSFER TYPE 
♦RESERVED 


Bits 3-7 Address Modifier: 

This byte must be cleared to 0x00 in the Initialize Controiier Command. 

Bug Memory Type (MT): 

The only valid entry In this 2-bit field is 0x3 (data is located in short I/O space). 
Table 5-8. Memory Type Field For Initialize Controller Command 


1 BIT 9 

BIT 8 

MEMORY TYPE 

■a 

mm 

(RESERVED) 

0 

1 

(RESERVED) 

1 

mm 

(RESERVED) 

1 

1 

Data is contained in short I/O 


Bits 10-11 Transfer Type (TT): 

This 2-bit field must be cleared to 0. 

Bits 12-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 
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BUFFER ADDRESS (4 BYTES) 

This field contains the off^ of the Controlier Initialization Block from the short I/O base 

a ddres s . 



MAXIMUM TRANSFER LENGTH (4 BYTES) 

This field specifies the maximum number of bytes that may be transferred by the 
command. 
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CONTROLLER INITIAUZATION BLOCK 

The Buffer AcJdress of the Initialize Controller lOPB points to a list of initialization parameters caiied the 
Controiier Initialization Block (CIB). The host must assemble the Controlier Initialization Block in the Host 
Usable Space (HUS) before issuing the initialize Controiier command. Once it issues the Initialize 
Controller command, the host cannot modify the OB unti it receives a Command Complete interrupt for 
the initialize command. 


The format of the Controller Initialization Block Is as foiiows: 



Figure 5-7. Controller initialization Block 
The following is a description of each field in the Controller Initialization Block. 


5-26 
































































lOPBs AND COMMANDS 


NUMBER OF COMMAND QUEUE ENTRIES (9 BYTES) 

This field sets the number of entries in the Command Queue. The Command Queue 
must have at least one entry. The maximum number of entries varies greatly depending 
on the application. If you are using onboard iOPBs, which require that both the 
Command Queue entry and its corresponding lOPB be written to Host Usable Space 
in short I/O. the maximum number of entries is relatively limited. A typical setup for 
onboard IOPBs is a 10-entry Command Queue. (Note, however, that each CQE/IOPB 
only resides in short I/C for a very short period of time before being transferred into the 
appropriate work queue.) 

A much larger Command Queue is allowed In applications using offboard IOPBs, in 
which the Jaguar DMAs IOPBs directly from system memory into the appropriate work 
queue. (See "Offboard IOPBs,* Chapter 6.) Nevertheless, the size of the Command 
Queue is stil appiicatiorKlependent The maximum number of Command Queue entries 
in a setup using offboard IOPBs typically ranges from 60 to 100 entries. 

DMA BURST COUNT (2 BYTES) 

The DMA Burst Count specifies, in bytes, the number of VMEbus transfers performed 
in a single burst before releasing and re-requesting the bus. The maximum burst values 
are 128 (512 ^ 4) for 32-bit transfers or 256 (512 -r 2) for 16-bit transfers. Setting the 
burst count to 0 will specify the maximum burst size. VMEbus transfers are either 16-bit 
or 32-bit; therefore, the burst count should be a byte multiple of the transfer size (i.e. 
2,4,6...256 for 16-bit transfers or 4,8.12...128 for 32-bit transfers). 

CONTROLLER NORMAL COMPLETION LEVEUVECTOR 
(2 BYTES) 

This field specifies the interrupt level arxl vector that the Jaguar will use when reporting 
the normal completion of the following two commands: 1) Rush Ail Queues and Report, 
and 2) Rush All Queues. 


UlDi 


r«i 


1 11 1 10 1 
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LdiJ 
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1 
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J L 


J L 


>INTERRUPT VECTOR 
^INTERRUPT LEVEL 
^-RESERVED 


BHt 0-7 interrupt Vector (IV): 

These bits set the Interrupt Vector used by the Jaguar when reporting normal controller 
interrupts. 

Bite 8-10 Interrupt Level (IL): 

These bits are the interrupt level used by the Jaguar when reporting normal controller 
interrupts. The host sets these bits and the Jaguar does not modify them. 

Bits 11-15 Reserved (RSRV): 

Bits 11 through 15 are reserved and should be cleared to 0 by the host. 
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CONTROLLER ERROR COMPLETION LEVEUVECTOR (2 BYTES) 

This field specifies the interrupt level and vector that the Jaguar will use when reporting 
a variety of controlier errors. Such errors wll not generate an interrupt if the interrupt 
level is set to 0. However, the board wll stil report such errors to the Command 
Response Block. For additional information on this field, refer to "Controller Error 
Interrupt and Vector". 



11 1 10 1 9 1 8 1 7 

□ 

3 

□ 

3|2|1 |0 


>INTERRUPT VECTOR 
♦INTERRUPT LEVEL 
♦RESERVED 


Bits 0-7 Interrupt Vector (IV): 

This byte is the Interrupt Vector used by the Jaguar when reporting Controller Error 
Interrupts. 

Bits 8-10 Interrupt Level (IL): 

These bits set the Interrupt Level used by the Jaguar when reporting the Controller Error 
Interrupts. 

Bits 11-15 Reserved (RSRV): 

Bits 11 through 15 are reserved and should be cleared to 0 by the host. 

PRIMARY SCSI BUS ID (2 BYTES) 

The Primary SCSI Bus ID specifies the ID the Jaguar uses for the SCSI bus address on 
Port 0. The Jaguar can either use Its default ID or It may use the value given in bits 0 
through 2. 
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♦PRIMARY SCSI BUS ID 

♦DEFAULT 

♦RESERVED 


Bits 0-2 Primary SCSI Bus ID (ID): 

If Bit 3 PFT) is cleared, the value stored in this field wll be used by the Jaguar as the 
Primary SCSI Bus ID. This field may have any value from QxO to 0x7. 

Bit 3 DsfouR (DFT): 

Setting the Default bit to' Tenables the Jaguar to use the default ID specified by Switch 
Block SW1. Clearing the Default bit causes the Jaguar to use the ID specified in the ID 
field (bits 0-2) of this word. 

Bits 4-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 


5-28 







lOPBs AND COMMANDS 


SECONDARY SOS! BUS ID (2 BYTES) 

The Secondary SCSI Bus ID specifies the ID the Jaguar uses for the SCSI bus address 
on Port 1. The Jaguar can either use Its default ID or it may use the value given in bits 
0 through 2. 



14 1 13 1 12 

1 11 1 10 1 
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I--, I 


-^PRIHARY SCSI BUS ID 

-M)EFAUS.T 

-PRESERVED 


Bits 0-2 Secondary SCSI Bus ID (ID): 

The host uses these 3 bits to specify the SCSI ID the Jaguar is to use for Port 1 when 
the DPT bit is 'O'.This field may have any value from 0x0 to 0x7. 

Bit 3 Deftiuit (DFT): 

Setting the Default bit to 'T enables the Jaguar to use the default ID specified by the 
SCSI daughter card's Jumpers. Qearing the Default bit causes the Jaguar to use the ID 
specified in the ID field (bits 0-2) of this word. 

Bits 4-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host 


COMMAND RESPONSE BLOCK OFFSET (2 BYTES) 

The Command Response Block Offset word specifies the starting address of the 
Command Response Block. By setting the Command Response Block Offset, the host 
is also specifying the length of the largest lOPB that can be transferred to the Jaguar. 
The largWt lOPB is equal to the offset of the Controller Specific Space (0x788) minus 
the Command Response Block Offset, minus 12 bytes. If the Command Response Block 
Offset is 0x73C, for example, the largest lOPB cannot exceed 64 bytes (0x788 - 0x73C - 
OxC). 

The Command Response Block Offset must allow for a Command Response Block of 
at least 18 bytes so that there wili always be enough room in the Command Response 
Block to include the status bytes of the returned lOPB. Attempting to use a Command 
Response Block Off^ that would result in a Command Response Block of less than 18 
bytes will result in the Initialize Controller Command completing with an error. 

SCSI SELECTION TIMEOUT (4 BYTES) 

The selection timeout causes an lOPB to be terminated with an error status if a device 
does not respond to selection within the programmed period of time. It is specified in 
increments of 1 mllisecond. The same value is used for ali devices. A value of 'O' 
specifies an infinite timeout In general, selection timeouts do not require error handling. 
They simply prevent the board from becoming locked up by trying to select a device 
that does not exist 
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WORK QUEUE 0 COMMAND TIMEOUT (4 BYTES) 

This timeout specifies a timeout value for commarxis issued through Work Queue 0. This 
field is specified in increments of appixDdmately 256msec. A value of 0 specifies no 
timeout. The Jaguar notifies the host of an lOPB timeout by use of the Controller Error 
interrupt This interrupt wll be used to return error status without returning the iOPB that 
caused the error. Bit 7 of the Command Response Status Word allows the allows the 
host to determine the source of the error. Also data returned in the command response 
block has been defined to specify the type of error that has occurred. Refer to "Error 
Recovery Tools" in Chapter 6 for additional details. 

VMEBUS TIMEOUT (4 BYTES) 

This long word field specifies the length of time the Jaguar wHI wait for a VMEbus 
transfer to complete. A value of t)* specifies a timeout of 100 milliseconds. Any other 
value specifies a timeout value In increments of approximately 30 milliseconds. 

OFFBOARD MEMORY TYPE/TRANSFER 
TYPE/ADDRESS MODIFIER (2 BYTES) 

This field is intended for applications which use the Jaguar's offboard IOPB feature (see 
"Offboard iOPBs" in Chapter 6. If tNs field and the Offboard Command Response 
Block Address field (below) are Xf, the Jaguar wll post the Command Response Block 
to the short I/O space only. If these fields are non-zero, then the Jaguar wll also post 
the Command Response Block to the specified offboard address. 

The Offboard Command Response Block Memory Type/TransferType/Address Modifier 
field are used when writing the Command Response Block to system memory. The 
format of this field is as follows. 


15 I U I 13 I 12 
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^ADDRESS MODIFIER 
*^N0RY TYPE 
^TRANSFER TYPE 
PRESERVED 


Bits 0-7 Address Modifier: 

This byte is the address modifier used for writing the Command Response Block to 
system memory. This byte is not changed by the Jaguar. 

Bits 0-0 Memory Type (MT): 

This two-bit field specifies the data transfer memory width used to write to the offboard 
Command Response Block. 
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Table 5-9. Memory Type Field For Offboard Command Response Block 


■IT 9 

BIT fi 

HBfORT TYPE 

0 

0 

(RESERVED) 

0 

1 

16-BIT TRANSFERS 

1 

0 

32-BIT TRANSFERS 

1 

1 

(RESERVED) 


Bits 10-11 Transfer Type (TT): 

This two-bit field specifies the type of transfer performed. 

Table 5-10. Transfer Type Field For Offboard Command Response Block 


BIT 11 

BIT 10 

TRANSFER TYPE 

0 

0 

NORMAL NODE 

0 

1 

BLOCK NODE 

1 

0 

(RESERVED) 

1 

1 

(RESERVED) 


Bits 12-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 

HOST MEMORY ADDRESS FOR OFFBOARD CRB (4 BYTES) 

This field is intended for applications which use the Jaguar's offboard lOPB feature (see 
"Offboard lOPBs* in Chapter 6). This address is used to write the Command Response 
Block to system memory. As noted above, if this field and the Offboard Command 
Response Block Memory Type/Transfer Type/Address Modifier field are both 'O', the 
Jaguar will post lOPBs to the onboard Command Response Block only. 

ERROR RECOVERY FLAGS (2 BYTES) 

This field is used to control error recovery features. Currently, one option - Freeze Work 
Queues on SCSI Reset - is supported: 
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Figure 5-8. Error Recovery Options In Controller Initialization Block 


5-31 

































INTERPHASE CORPORATION 


Setting Bit 0 causes the Jaguar to freeze a work queue if a Reset occurs on the SCSI 
bus whHe a command is active on the bus from that work queue. With this feature 
enabied, the host "knows'the work queue is frozen if a command is returned from the 
queue with a SCSi bus reset error status. This aiiows it to decide how to handle the 
SCSI reset before permitting new commands to be sent to the device. This is the 
preferred mode of operation. In general, the bit shouid oriiy be deared if you need to 
maintain driver compatiblity with earlier firmware that did not freeze work queues after 
a SCSi reset had terminated a command from that queue. Refer to Chapter 6. '' Error 
Recovery Toois", for more information. 

RETURNED VALUES 

Upon command compietion, the foiiowing information is provided by the Jaguar in the returned 
lOPB for the Initialize Controiier command: 

RETURN STATUS (2 BYTES) 

These two bytes hoid the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in Appendix C. 
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INITIAUZE WORK QUEUE (0x42) 

The Initialize Work Queue command is used to configure Work Queues 1 -14. Each work queue must 
be initialized with a separate initialize Work Queue command. 

This command must be issued through the Master Command Entry to Work Queue 0. 


NOTE 



The format of the initialize Work Queue iOPB is as fbliows: 



NOTES: 

Fields set In bold letters are returned values. 

AH other values are host provided. Reserved fields 
must be cleared to 0 by the host 

Figure 5-9. initiaiize Work Queue iOPB 

The remainder of this section describes the function of each field in the Initiaiize Work Queue 
IOPB. 
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HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Initialize Work Queue command: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x42 to execute the Initialize Work Queue command. 

COMMAND OPTIONS (2 BYTES) 

This field contains the options for thb command. The bits are defined as follows: 


mji] 

13 1 12 1 11 

10 1 9 

LlM 

0 

m 



1-1-1 1—♦INTERRUPT ENABLE 


PRESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to biterrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt 


Bits 1-15 Reserved: 


These bits are reserved and must be cleared to 0 by the host 

NORMAL COMPLETION VECTOR/ERROR COMPLETION 
VECTOR (2 BYTES) 


These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 


1 15 1 14 1 13 1 12 1 11 1 10 1 9 
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TTTTT 

THTl 

1 i 1 1 


♦ERROR COMPLETION VECTOR 
♦NORMAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 


This value specifies the interrupt vector used when notifying the host of command 
completion with error. 


Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 
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j i3 j 14 [ 13 j 12 I n I 10 I y I 




*>I»iTERRUPT LEVEL 

*>RESERVED 


Bits (V-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 Is allowed 
only when interrupts are disabled (interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

WORK QUEUE NUMBER (2 BYTES) 

This number identifies which work queue to initialize. Each work queue must be 
assigned a unique number. Valid entries in this field are 0x1 > OxE to initialize Work 
Queues 1 -14, respectively. 

WORK QUEUE OPTIONS (2 BYTES) 

This field is used to set a variety of options this work queue. 
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- ■■ -i i^ABORT ENABLE 

-►RESERVED 

-►FREEZE ON ERROR 

-►PARITY ENABLE 

-►RESERVED 

-►INITIALIZE WORK QUEUE 

Bit 0 Abort Enable (AE): 

Setting Bit 0 enables the Jaguar to abort all lOPBs in the work queue, and all lOPBs in 
the Command Queue entry destined for the work queue, when an lOPB from this queue 
completes with an error. 

Clearing the bit disables the aborting of remaining queue entries when one command 
terminates with an error. (See Queue Entry Control Register, Abort Acknowledge bit). 

BH 1 Reserved (RSRV): 

This bit is reserved and must be cleared to 0 by the host 
Bit 2 Freeze on Error (FZE): 

The Freeze Work bit (FZE) is set during the Work Queue Init command. This attribute 
w8l be in effect for that queue only. All commands that do not return a good status will 
freeze the queue. When the host sees a command return from a work queue that has 
Freeze on Enxx enabled with a SCSI device error, the host must unfreeze (thaw) the 
work queue after taking the error handling steps needed for that particular error. 
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The frozen work queue is unfrozen by selecting that work queue number in the Thaw 
Queue Register and then setting Bit 0 of that register. The Jaguar will dear the register 
to acknowledge the thawing of the work queue. The Thaw Work Queue Status Register 
is located in the fourth word of the Master Control/Status Block. 

Refer to Chapter 6. 'Error Recovery Tods', for a discussion of freeze/thaw work queue 
operation. 

Btt 3 Parity Enable (PE): 

The Parity Enable bit enables SCSI bus parity checking for commands issued from the 
work queue. 

Bits 4-14 Reserved: 

These bits are reserved and must be deared to 0 by the host 
Bit 15 Initialize Work Queue (IWQ): 

The Initialize Work Queue OWQ) bit causes the Jaguar to initialize the work queue even 
if it has been previously initialized. If commands are pending when the Jaguar attempts 
to execute an Initialize Work Queue command, the initialize Work Queue lOPB will not 
be executed and the lOPB wW return with an error status. 

NUMBER OF SLOTS (2 BYTES) 

This field contains the number of slots in the work queue. Each work queue can have 
as many slots as you want However. If the total number of commarxis queued-up in 
the Jaguar's internal work queues reaches a certain number (approx. 100). the board 
wM not accept additional commands from the Command Queue unti work queue space 
is freed up. No error message is generated. 

COMMAND TIMEOUT (2 BYTES) 

This value specifies the maximum time that a command issued to this work queue 
should take to execute after the device has been selected. This allows each work queue 
(i.e. SCSI device) to run a unique timeout value. The timeout value is used from the 
successful completion of the selection phase untl the completion of the command on 
the SCSI bus. This timeout indudes all disconnect periods. The timeout is specifled in 
increments of approximately 256msec. That is. a value of 0x1 in this field specifies a 
timeout perkxi of approximately 256msec. NOTE: The actual value may vary between 
220 and 280msec. 

If the timeout value is non-zero, the Jaguar wll issue a Contrdler Error Interrupt when 
the timeout period expires. The Jaguar notifies the host of the command timeout by use 
of the Controller Error InterrupL This interrupt returns an error status without returning 
the lOPB that caused the error. Bit 7 of the Command Response Status Word allows the 
allows the host to determine the source of the error. Also, data returned in the 
Command Response Block can be used to help determine the type of error that has 
occurred. Refer to " Command Timeouf in Chapter 6 for additional information. 
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RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
lOPB for the initialize Work Queue command. 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in Appendix C. 
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DUMP INITIAUZATION PARAMETERS (0x43) 

The Dump Initializatkxi Parameters commarxt causes the Jaguar to report its current Initialization/setup 
information to the host. This commanci is interxieci to be used primarily for diagnostic purposes. 

This command must be issued through the Master Commarxl Entry to Work Queue 0. 


The format of the iOPB for the Dump initialization Paiameters command is shown below: 



NOTES: 

Fields set in bold capital letters are returned values. 
AH other values are host provided. Reserved fields 
must be cleared to 0 by the host 

Figure 5-10. Dump Initialization Parameters IOPB 


The remainder of this section describes the function of each field in the Dump Initialization Parameters 
IOPB. 


HOST-PROVIDED IOPB FIELDS 

The foliowing information must be provided in the IOPB for the Dump initialization Parameters 
command: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x43 to execute the Dump Initialization Parameters command. 
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COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as foiiows: 
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E 
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□ 



^INTERRUPT ENABLE 
-PRESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enabies the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Comf^ete interrupt 

Bite 1-15 Reserved: 

These bits are resented and must be cleared to 0 by the host. 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 


I 1^ I 14 I It I 1? 1 11 I in I o I ft I 7 i A I c I 4 I T I 9 i 1 Ini 

i ; i i - ! - I i - I I 7 I ; i - I - I I - i - i - I - i 


Bits 0-7 Error Completion Vector: 


TERROR COHPLETION VECTOR 
4>N0RHAL COHPLETION VECTOR 


This value specifies the interrupt vector used when notifying the host of command 
completion with error. 


Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 
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] [ 


Bits 0-2 Interrupt Level (LVL): 


♦INTERRUPT LEVEL 
♦RESERVED 


These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (interrupt Enable bit = 0 in the Command Options 
word). 
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Bits 3-15 Reserved: 


These bits are reserved aixl must be cleared to 0 by the host. 

MEMORY TYPEH'RANSFER TYPeADDRESS MODIFIER 
(2 BYTES) 


This specifies the memory type and address modifier to be used for any VMEbus 
transfers associated with the Dump Initialization Parameters command. 



Bits 0-7 Address Modifier: 

This byte must be cleared for the Dump Initialization Parameters command. 

PttS 3—0 |y|0|i|l0py i 

The oNy valid entry in this 2-bit field is 0x3, indicating that the data for this command 
is locat^ in short I/O. 


Table 5-11. Memory Type (MT) Field For Dump Initialization Parameters Command 


BIT 9 

BIT 8 

MEMORY TYPE 

0 

0 

(RESERVED) 

0 

1 

(RESERVED) 

1 

0 

(RESERVED) 

1 

1 

Data is contained in short I/O 


Bits 10-11 Transfer Type (Tf): 

These bits must be cleared to 0. 
Bits 12-15 Reserved (RSRV): 


These bits are reserved and must be cleared to 0 by the host. 




















lOPBs AND COMMANDS 


BUFFER ADDRESS (4 BYTES) 

This field specifies the offset into short I/O at which the Jaguar is to start writing the 
initialization parameter list NOTE: The list should be written into Host Usable Space. 



MAXIMUM TRANSFER LENGTH (4 BYTES) 

This field specifies the maximum number of bytes that may be transferred by the 
command. 



riE I 


Upon command completion, the following information is provided by the Jaguar in the returned 
iOPB for the Dump Initialization Parameters command: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in Appendix C. 

The Jaguar also writes the initialization parameters to the section of short I/O specified 
by the host, as discussed on the next page. 
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DUMP INITIAUZATION PARAMETERS BLOCK 

When It executes the Dump Initialization Parameters command, the Jaguar writes the parameter list into 
short I/O, starting at the offset provided in the Buffer Address field of the lOPB. 


The parameter list, which has the same format as the Controlier Initialization Block, is depicted below: 



For an explanation of the fields in the Dump initialization Parameters Block, please refer to the Controller 
initiaiizati^ Block. 
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DUMP WORK QUEUE PARAMETERS (0x44) 

The Dump Work Queue Parameters command causes the Jaguar to report the current parameters of an 
individual work queue to the host. The host provides the work queue number. Note that a work queue 
must be initialized before its parameters can be dumped. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The fomriat of the lOPB for the Dump Work Queue Parameters commaixi is shown below: 



M other values are host provided. Reserved fields 
must be cleared to 0 by the host 

Figure 5-12. Dump Work Queue Parameters lOPB 

The remainder of this section describes the function of each field in the Dump Work Queue Parameters 
lOPB. 


HOST-PROVIDED lOPB FIELDS 

The following Information must be provided in the lOPB for the Dump Work Queue Parameters 
comrrtand: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x44 to execute the Dump Work Queue Parameters command. 
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COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 
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INTERRUPT ENABLE 
-»>RESERVED 


BH 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar wRI use to report 
normal command completion and command completion with error. 


DE 

H 1 13 1 12 1 11 1 10 1 9 1 8 1 7 

«|S|4|3|2 
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TERROR COMPLETION VECTOR 
-^NORMAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 


10 1 9 1 8 1 7 
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EM 


♦INTERRUPT LEVEL 
♦RESERVED 
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Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 In the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

WORK QUEUE NUMBER (2 BYTES) 

This number Identifies the work queue whose parameters are to be dumped. Legal 
values In the field are 0x1 • OxE ^or Work Queues 1 -14, respectively). If you specify 
an uninitialized work queue, the command wBI complete with an error and an illegal 
parameter status. 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
iOPB for the Dump Work Queue Parameters command: 


RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in App^ix C. 

WORK QUEUE OPTIONS (2 BYTES) 

This field contains the work queue options specified by the host when it initialized the 
work queue. 

NUMBER OF WORK QUEUE SLOTS (2 BYTES) 

This field contains the number of work queue slots specified by the host v/hen it 
initialized the work queue. 

COMMAND TIMEOUT (2 BYTES) 

This field contains the command timeout specified by the host when it initialized the 
work queue. 
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BUS STATUS INQUIRY (0x45) 

The Bus Status inquiry command returns the command tag of any iOPB currentiy executing on the 
seiected SCSi bus (Port 0 or Port 1). in addition it returns the command tags of any in-progress iOPBs. 
An in-progress iOPB is one which has been sent to a device but is not completed yet. Information in the 
returned IOPB can be used to identify which IOPB and device is causing an error condition. 

During execution of this command, the Jaguar wii stop all internal operations so that the response will 
reflect the state of the board at the time the Bus Status Inquiry IOPB is executed. 

This command must be issued through the Master Command Entry to Work Queue 0. 


The format of the Bus Status Inquiry IOPB is as foiiows: 



Note that word OkF in the above IOPB Is issued with a host-provided value, but relumed 
with a Jaguar-provided value. Reserved fields murt be cleared to 0 by the host 

Figure 5-13. Bus Status Inquiry IOPB 

The remainder of this section describes the function of each field in the Bus Status inquiry IOPB. 

HOST-PROVIDED IOPB FIELDS 

The foliowing information must be provided in the IOPB for the Bus Status inquiry command: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x45 to execute the Bus Status Inquiry command. 
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COMMAND OPTIONS (2 BYTES) 

This field contains the options for this comntand. The bits are defined as follows: 
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(^INTERRUPT ENABLE 
-»>RESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 
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♦ERROR COMPLETION VECTOR 
♦NORMAL COMPLETION VECTOR 


Bits (K-7 Error Completion Vector: 


This value specifies the interrupt vector used when notifying the host of command 
completion with error. 


Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 
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♦INTERRUPT LEVEL 
♦RESERVED 


Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (interrupt Enable bit = 0 in the Command Options 
word). 
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BHt 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

BUS SELECTION (2 BYTES) 

This field specifies which SCSI bus is the subject of the bus status inquiry. 


CE 

11 1 10 1 9 1 8 

I 

I 

I 

I 



♦RESERVED 

♦BUS 

♦RESERVED 


Bits 0-5 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 6 Bus: 

Clearing the Bus bit selects the primary SCSI bus (Port 0). Setting the bit selects the 
SCSI bUS (PO!t 1). 

Bits 7-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
lOPB for the Bus Status Inquiry command: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in App^ix C. 

ACTIVE COMMAND TAG (4 BYTES) 

The Active Command Tag field contains the command tag of a SCSI Pass-Through 
lOPB, if the command is being executed on the bus at the time that the Bus Status 
inquiry is issued. 

BUSY COMMAND TAGS 

The Busy Command Tags fields wii contain any other currently "in-progress” lOPBs that 
may not be able to complete due to the "hung" active command. There can be up to 
seven busy commands per port (words 0x8 - 0x9, OxA - OxB, OxC - OxD, OxE - OxF, 
0x10 - 0x11, 0x12 - 0x13, 0x14 - 0x15). NOTE: The host-provided value in word OxF 
(Bus Selection) wHI be overwritten. 
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COMMAND STATUS INQUiRY (0x46) 

This lOPB returns the state of a previously issued lOPB based on the command field, if the iOPB 
specified by the command tag is active on the bus, information wil be returned to help identify the state 
of the SCSI activity. The Jaguar wHI suspend hardware operations untH the status of the command is 
found and posted. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the IOPB Is as follows: 



NOTES: 

Helds set in bold capital letters are r^med values. Al other values 
are host provided. Reserved fields must be cleared to 0 by the host 

Figure 5-14. Command Status Inquiry IOPB 

The remainder of this section describes the function of each field in the Command Status Inquiry IOPB. 

HOST-PROVIDED IOPB FIELDS 

The following information must be provided in the IOPB for the Command Status Inquiry: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x46 to execute the Command Status Inquiry command. 

COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 
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INTERRUPT ENABLE 
-PRESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

NORMAL COMPLETION VECTOR ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

i 15 I U I 13 i 12 I 11 [ 10 I 9 j 8 j 7 I 6 I 5 I * I 3 j 2 I 1 I 0 [ 

[ — _-»error completion vector 
-►normal completion vector 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 
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♦interrupt level 

♦RESERVED 


Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 In the Command Options 
wo^). 
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Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

RETURNED VALUES 

Upon command completion, the following Information is provided by the Jaguar in the returned 
iOPB for the Command Status Inquiry: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in App^ix C. 

COMMAND STATUS FIELD AND ACTIVE COMMAND 
INFORMATION (6 BYTES) 

Word 0x12 contains the returned command status. If the command is active, additional 
information is returned in words 0x13 and 0x14, as shown below: 



Figure 5-15. Returned Fields for Command Status Inquiry 


Valid returned values for the Command Status Reid (CSF) are as follows: 
Table 5-12. Returned Values for Command Status Field 


CODE 

EXPLANATION 

0x0001 

Command not found (command tag dkl not nratch) 

0X0002 

Command not In work queue (not executing yet) 

0X0003 

Command cuirently active (currently on SCSI bus) 

0x0004 

Command busy (currentiy disconnected) 

0x0005 

Command on Done Queue (The command is on the Jaguar' 
internal Done Queue and wl have been received by 
the host before the response to the inquiry) 

0x0006 

Command in commeuKi queue (siH in short I/O) 
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ACTIVE COMMAND ADDITIONAL INFORMATION FIELDS 

If the command inquired about is currently active (0x03), the state of the controller and 
the SCSI bus is also reported back In two additkxial fields - LCMD (Last Command 
Issued to the Jaguar's SCSI Controlier (Fujitsu 87030) and PSNS (phase sense). 

Last Command Issued. This field Irxiicates the last command issued to the 
Jaguar’s SCSI controlier (Fujitsu 87030). Valid returned values are shown 
below: 

Table 5-13. Returned Values in Last Command Field 


CODE 

EXPLANATION 

0X0000 

Bus Reiease 

0x0001 

Select Device 

1 0x0002 

Reset Attention 

0x0003 

Set Attention 

0X0004 

Transfer Data 

1 0x0005 

Transfer Data Pause | 

1 0x0006 

Reset SCSI Handshake Line | 

1 0X0007 

Set SCSI Handshake Line | 


Phase Sense. This field Indicates the current SCSI bus status. Valid returned 
values are shown below. 

Table 5-14. Returned Values In Phase Sense Field 


CODE 

EXPLANATION 

0x0007 

Request | 

0x0006 

Acknowledge | 

0X0005 

Attention | 

0X0004 

Select 1 

0x0003 

Busy 1 

0X0002 

Message | 

0X0001 

Corrvnand/Data | 

0x0000 

Input/Output 1 
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CANCEL COMMAND TAO (0x48) 

This iOPB cancels the execution of a praviously issued lOPB, based on the command tag specified in 
words 10-11 of the Cancei Command Tag IOPB. issuing the command causes the Jaguar to find and 
cancel the first command tag that matches the one given in the IOPB. If multiple lOPBs exist with the 
same command tag, only the first one found wll be canceled. If the Jaguar is unable to locate a 
command whose tag matches the one in the IOPB, It will return the Cancel Command Tag IOPB with 
an error. 

This command must be issued through the Master Command Entry to Work Queue 0. 

If an IOPB is canceled and subsequent SCSI activity attempts to complete the command, the Jaguar will 
return a controller error indicating that a device has connected for which there is no IOPB. 

NOTE 


MtHy if* cemstaad lags for ^ itXPSs nsidiiig ost^ 


The format of the Cancei Command Tag IOPB is shown below. 



NOTES: 

Rekjs set In bold capital letters are returned values. Al other values are host 
provided. Reserved fields must be cleared to 0 by the host 


Figure 5-16. Cancei Command Tag IOPB 

The remainder of this section describes the function of each field in the Cancel Command Tag IOPB. 
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HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Cancel Command Tag command: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x48 to execute the Cancel Command Tag command. 

COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 
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LH^INTERRUPT enable 
-»>RESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus irtterrupt vectors that the Jaguar wll use to report 
normal command compi^ion and command completion with error. 


15 1 14 1 13 1 12 1 11 1 10 

ffpi 

6 

Ll! 



-►ERROR COMPLETION VECTOR 
^NORMAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 
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] - ^ 

I 


m 


>INTERRUPT LEVEL 
-^-RESERVED 


BH8 0-2 Interrupt Level (LVL): 

These bits set the interrupt levei used by the Jaguar to assert a Command Compiete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is aiiowed 
only when interrupts are disabled (interrupt Enable bit = 0 in the Command Options 
wo^). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

COMMAND TAG (4 BYTES) 

This field specifies command tag of the lOPB which is to be canceled. 



RETURNED VALUES 


Upon command completion, the following information is provided by the Jaguar in the returned 
lOPB for the Cancel Command Tag command: 

RETURN STATUS (2 BYTES) 


These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in Appendix C. 
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FLUSH WORK QUEUE (0x49) 

The Rush Work Queue command flushes all commands that have been placed in the work queue, as 
well as any commands in the Command Queue destined for the work queue. (This is different from the 
Rush Queue bits in the Master Control Register. This command flushes only the specified work queue; 
the Rush Queue bits in the MCR flush ail the queues.) This command specifies the work queue number 
and has, as an option, the ability to report completion of each entry in the queue. 

This command must be issued through the Master Command Entry to Work Queue 0. 

At the completion of the Rush Work Queue command, the number of entries flushed from the queue will 
be returned. The returned lOPB will also report whether any commands were "irProgress" when the 
Rush Work Queue command was executed. 

If any of the flushed commands are '' InProgressT, It may be necessary to reset the SCSI bus in order 
to dear the effects of the command out of the target To do so, issue a Reset SCSI Bus lOPB. 

The format of the lOPB is as foiiows: 


WORD* 



13 12 11 10 8 1 8 

76 543210 

0x0 

COMMAND CODE (0x48) 

0x1 

COMMAND OPTIONS 

0X2 

RETURN STATUS 

0X3 

RESERVED 

0x4 

NORMAL COMPLETION VECTOR 

ERROR COMPLETION VECTOR 

0X5 

INTERRUPT LEVEL 

0X6 

To 

0x0 

RESERVED 

1 

WORK QUEUE NUMBER 

1 OxF 

SIP 

PIP 

NUMBER OF ENTRIES FLUSHED 


NOTES: 

Rekte set In bold capital lettare are returned values. Al other values 
are host provided. Reserved fields must be cleared to 0 by the host 


Figure 5-17. Rush Work Queue lOPB 

The remainder of this section describes the function of each field in the Rush Work Queue lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Rush Work Queue command; 
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lOPBs AND COMMANDS 


COMMAND CODE (2 BYTES) 

This field must be set to 0x49 to execute the Rush Work Queue command. 

COMMAND OPTIONS (2 BYTES) 


This field contains the options for this command. The bits are defined as foiiows: 



B 

B 

1 12 1 11 


□ 

S|7|6|5|4|3|2 


I^INTERRUPT ENABLE 
—►RESERVED 

—►REPORT FLUSHED COHHANDS 
—►RESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. Note that it is not necessary 
to enabie this bit in order to use Bit 8 (RPT), beiow. 

Bits 1-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host 
Bit 8 Report Flushed Commands (RPT): 

Setting this bit causes the Jaguar to report each command as it is flushed with a 
Command Complete interrupt and an Error Status. Clearing the bit disabies this function. 
NOTE: Oniy the commands that have the interrupt Enabie bit set in the Command 
Options word of their individual iOPBs will generate an interrupt as they are flushed. 

Bits 9-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

WORK QUEUE NUMBER (2 BYTES) 

This is the number of the work queue to be flushed. The host can also flush all of the 
work queues and the Command Queue by setting the Rush Queue bits in the Master 
Control Register (see Master Control Register). 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar wili use to report 
normal command completion and command completion with error. 


B 

B 

B 

B 

B 


□ 

□ 

[zhj 

LlLJ 

\ih\ 

□ 

□ 


-►ERROR COMPLETION VECTOR 
►>NORNAL COMPLETION VECTOR 









INTERPHASE CSDUPORATION 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus bSemipt level used to notify the host of a command 
completion (normal or with error). 


nm] 

K 

CO 

o 

CM 


□ 

□ 


>INTERRUPT LEVEL 
♦RESERVED 


Sits C-2 internipi Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
lOPB for the Rush Work Queue command: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in App^ix C. 

NUMBER OF COMMANDS FLUSHED/FLUSHED IN PROGRESS 
COMMAND (2 BYTES) 




B 

B 

1 11 1 10 1 

a 

□ 

D 

□ 

□ 

□B 

BB 

B 


♦NUMBER OF COMMANDS FLUSHED 

♦PRIMARY BUS (PORT 0} COMMAND IN PROGRESS 

♦SECONDARY BUS (PORT 1) COMMAND IN PROGRESS 
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lOPBs AND COMMANDS 


Bits 0-13 Numbers of Entries Flushed: 

This is the number of entries that were flushed from the work queue. 

Bit 14 Primary Bus (Port 0) Command In Progress (PIP): 

The Jaguar sets this bit in the returned lOPB when an In Progress command is present 
on the primary SCSI bus. There can never be more than one In Progress command for 
any one work queue, but because the SCSI bus aUows targets to disconnect, there can 
be multiple In Progress commands on each SCSI bus. 

Bit 15 Secondary Bus (Port 1) Command In Progress (SIP): 

The Jaguar sets this bit in the returned lOPB when an in Progress command is present 
on the secondary SCSI bus. 
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INTERPHASE CORPORATION 


INITIALIZE PRINTER PORT (0x4A) 

The Initialize Printer Port command is used to configure the printer port for the interface being used 
pataproducts or Centronics). In addition, it enables/disables status change interrupts. NOTE: The vector 
used for status change interrupts is stored in word 0x2 of the Controlier initialization Block (the lower 
byte of the Controller Normal Completion Level/Vector field). 

As discussed in Chapter 6, the printer port requires a separate work queue. You must therefore create 
a work queue for the printer port using the Initialize Work Queue comniand before attempting to initialize 
the port. Initialize Printer Port is the first command that should be sent to this work queue. 

The Initialize Printer Port command can be Issued at any time to reset the printer port The command 
is issued with the reset bit set to dear the printer port hardware. It should never be necessary to reset 
the hardware. 

The command may also be issued at any time to assert a buffer dear to the printer. Since the time 
required for holding this signal varies from printer to printer, the Jaguar will leave the line set untH the 
host issues another Initialize Printer Port command with the bit deared. 

The format of the Initialize Printer Port lOPB is as fdlows: 


WORD* 

1 

1 

1 

QKO 

COMMAND CODE (0x4A) 

0X1 

COMMAND OPTIONS 

0x2 

RETURN STATUS 

0X3 

RESERVED 

0x4 

NORMAL COMPLETION VECTOR ERROR COMPLEhON VECTOR 

OXS 

INTERRUPT LEVEL 

0x6 

To 

OxD 

RESERVED 

OxE 

PRINTER OPTIONS 

OxF 

To 

0x15 

RESERVED 


NOTES: 

Reids set in bold capital letters are rMimed values. Al other vakies 
are host provided. Reserved fields must be cleared to 0 by the host 


Figure 5-18. Initialize Printer Port lOPB 

The remainder of this section describes the function of each field in the Initialize Printer Port iOPB. 
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lOPBs AND COMMANDS 


HOST-PROVIDED iOPB FIELDS 

The following information must be provided bi the IOPB for the Initialize Printer Port command: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x4A to execute the Initialize Printer Port command. 

COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 


1 12 1 11 

_1L 

I 

I 

I 

6 S 


I 

3 


■-^INTERRUPT ENABLE 
—►RESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Comf^ete interrupt 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

NORMAL COMPLETION VECTOR/ERROR COMPLETION 

VECTOR (2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar wBi use to report 
normal command completion and command completion with error. 


nr 

Z 

JL 

11 1 10 1 9 

I 

I 

Jil 

±Li. 

I 

I 



♦ERROR COMPLETION VECTOR 
♦NORMAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the intenupt vector used when notifying the host that the command 
completed without error. 
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INTERPHASE CORPORATION 


INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 


lEi 


11 1 10 1 9 

□ 


□ 

hhj 

□ 


I I I , I 

interrupt enable 

-►RESERVED 

Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

PRINTER OPTIONS (2 BYTES) 


The field provides the following options: 


□EJ 

n*i 



QD 


3 

□ 

□ 

6 

□ 

□ 

□ 

□ 

□ 


I . ^ C 


>-►STATUS CHANGE INTERRUPT ENABLE 

-RESERVED 

-►BUFFER CLEAR/PRINTER INIT 

-KDD/EVEN 

-►RESET 

Bits 0-7 Status Change Interrupt Enable: 

This field is used to enable interrupts from the printer status lines which the host is to 
monitor. To enable a specific status line, set the appropriate bit. The field's bit 
definitions vary depending the printer type, as listed below: 

Table 5>15. Printer Status Change Interrupt Reid 


Dataproducts Printers: 

Centronics Printers: | 

Bit7-> Reserved-0 

Bit7- Reserved-O 

Bits- Reserved-O 

Bite- Reserved-O 

Bits - Reserved - 0 

Bits- Reserved-O | 

Bit4- Reserved-O 

Bit4- Reserved-O | 

Bits - Cable On 

Bits - Reserved - 0 

Bits- Parity Error 

Bit 2- Paper Empty 

Bit 1 - Online 

Bill - Select 

BitO- Ready 

BitO- Fault 


NOTE: These signals are active high. 
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lOPBs AND COMMANDS 


Bits 8-12 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 13 Buffer Clear/Printer Init (BC): 

Issuing the Initialize Printer Port command with this bit set causes the Jaguar to assert 
a Buffer Clear to a Dataproducts prii^ or a Print Init to a Centronics printer. 

NOTE 


Meru$^ Bit 13 8 i 

tfHi bo^ Issue srratlw IniiSallze Port 




Bit 14 Odd/Even (0/E): 

This bit applies to Dataproducts printers only. It specifies the parity polarity, as 
follows: 


0 = Even Parity 
1 = Odd Parity 

BH 19 n«9«t inBiJ; 

Issuing the Initialize Printer Port command with this bit set causes the Jaguar to reset 
the printer port The port wili be ready to receive new print commands after the 
completion status has been returned to the host 


RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
iOPB for the Initialize Printer Port command: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in Appendix C. 
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RESTART CONTROLLER (0x4B) 

The Restart Controller command provides a method of res^tlng the controller and bypassing the power- 
up diagnostics. This command is analogous to a soft reset that tells the board to dear all current 
operations. 

The first action the board takes is to reset the SCSI ports. It then flushes all internal commands, with the 
exception of the Restart Controller command. Next, the Command Queue pointer Is reset to the base 
of the Command Queue. Finally, the Restart Controller command is returned to the Command Response 
Block. 

All Controller initialization Block parameters remain intact, and the board remains in Queue Mode (if it 
was in Queue Mode when the command was issued). 

This command must be issued through the Master Command Entry to Work Queue 0. 

NOTE 



I alter ea^ecutkig the Reetart Controfler depend^ on viM 


The format of the lOPB is as follows: 



NOTES: 

Relds set in bold capital lenere are returned values. 
Al other values are host provided. Reserved fields 
rrwst be cleared to 0 by the host 


Figure 5-19. Restart Controller lOPB 


The remainder of this section describes the function of each field in the Restart Controiier iOPB. 
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lOPBs AND CX>MMANDS 


HOST-PROVIDEP !OPB FIELDS 

The following Information must be provided in the lOPB for the Restart Controlier command: 

COMMAND CODE (2 BYTES) 

This field must be set to Qx4B to execute the Restart Controller command. 

COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 


h. 

13 

12 1 11 1 10 1 9 1 8 1 7 

6 

5 1 4 1 3 1 2 

_L 

0 


^INTERRUPT ENABLE 
-PRESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the CommarxJ Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 



nr] 

B 

12 1 11 1 10 

9 

0 

□ 

E 

ih. 

□ 

hr 

□ 


I I I I 


TERROR COMPLETION VECTOR 
-•^NORHAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 
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INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 



1 12 1 11 1 

nn 

1 9 1 8 1 

FFFl 

□ 

□ 

LiM 

□ 


15 14 


J L 


INTERRUPT LEVEL 
♦RESERVED 


Bits Q-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 thrcHjgh 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

RETURNED VALUES 

Upon command completion, the foUowing information is provided by the Jaguar in the returned 
lOPB for the Restart Controlier command: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in App^ix C. 
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DEVICE REINITIAUZE (0x40) 

The Device Reinitialize command clears the first connection (synchronous negotiation state) of a device. 
This causes the Jaguar to retry the synchrorKXJS message on the next selection to the target. This 
command is only necessary when a dev^ has been disconnected from a bus and power cycled without 
the Jaguar having any information about this action. 

The format of the lOPB is as foiiows: 



NOTES: 

Reids set in bold ci^^ital letters are returned values. 

Al other values are host provided. Reserved fields 
must be cleared to 0 by the host 

Figure &-20. Device Reinitialize lOPB 

The remainder of this section describes the function of each field in the Device Reinitialize lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided In the lOPB for the Device Reinitialize command: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x40 to execute the Device Reinitialize command. 

COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 
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BOTRPHASE CORPORATION 


15 1 14 1 13 1 12 1 11 1 10 

□ 

□ 


EEH 

[!□ 


^INTERRUPT ENABLE 
—PRESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Comf^ete interrupt 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar wiil use to report 
normal command completion and command completion with error. 


I» h* I»I« 


11 1 10 { 

9 

8 

iL 

6 1 

5 

4 

3 

2 

4 

0 


TERROR COMPLETION VECTOR 
^NORMAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion ^h error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus Interrupt level used to notify the host of a command 
completion (normal or with error). 


I 15 I 14 I 13 I 12 I 11 I 10 I 9 I 8 I 7 I 6 I 5 I 4 I 3 I 2 I 1 I 0 I 


♦INTERRUPT LEVEL 
♦RESERVED 


Bits 8-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled Onterrupt Enable bit = 0 in the Command Options 
word). 
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Bits 3-15 Reserved: 


These bits are reserved and must be cleared to 0 by the host. 

UNIT ADDRESS (2 BYTES) 

This field specifies the SCSi bus and the address of the target device. 



Bits 0-2 SCSI Device ID (SCSI ID): 

These three bits are the SCSi Bus ID (SCSI ID) of the specified device. 

Bits 3-5 Logical Unit Number (LUN): 

These bits describe the SCSI Logical Unit Number (LUN) of the specified device. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit select which of the two SOS! buses the Jaguar uses 
when executing the command. When the BUS bit is cleared to 0, the Jaguar executes 
the command over the primary SCSi bus (Port 0). When set to 1, it uses the secondary 
SCSI bus (Port 1). 

Bits 7-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
iOPB for the Device Reinitialize command: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes is provided in App^ix C. 
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INTTERPHASE CORPORATION 


ISSUE BUS DEVICE RESET MESSAGE (0x4D) 

This message is sent from the initiator to direct a target to dear aii current commands on that SCSI 
device. This message forces the SCSi device to an biitiai state with no operations pending for any 
initiator. Upon recognizing this message, the target goes to the Bus Free phase. 

This command enables the host to reset indMduai devices on the bus. The host should issue this 
command after insuring that no commands are currently being executed on this device. 

This command must be issued through the Maister Command Entry to Work Queue 0. 


NOTE 



The format of the lOPB is as follows: 


WORD# 

imiilBnUMMnilHIIBBMM 

0X0 

COMMAND CODE (0x4D) 

0X1 

COMMAND OPTIONS 

0X2 

RETURN STATUS 

0X3 

RESERVED 

0x4 

NORMAL COMPLETION VECTOR ERROR COMPLETION VECTOR 

0X5 

INTERRUPT LEVEL 

0x6 

To 

OxE 

RESERVED 

OxF 

UNIT ADDRESS 

0X10 

TO 

1 0x15 

RESERVED 


NOTES: 

Fields set in bold capital letters are returned values. 

Al other values are host provided. Reserved fields 
must be cleared to 0 by the hML 

Figure 5-21. Issue Bus Device Reset Message iOPB 

The remairxier of this section describes the function of each field in the Issue Bus Device Reset Message 
IOPB. 

HOST-PROVIDED IOPB FIELDS 

The following information must be provided in the IOPB for the issue Bus Device Reset Message 
command: 
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lOPBs AND COMMANDS 


COMMAND CODE (2 BYTES) 

This field must be set to 0x4D to execute the issue Bus Device Reset Message 
command. 

COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 



0 

0 

0 

0 

0 

□ 


|7|6|5 

□ 

LM 

□ 


J I^INTERRUPT ENABLE 
-►RESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 


1 14 

13 1 12 

11 

10 

9 

8 

_L 

6|5|4|3|2|l 


■►ERROR COMPLETION VECTOR 
►NORMAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 


LilM 

1 13 1 12 1 

1 11 1 10 1 

□ 

□ 

m 

0 

□ 

□ 

□ 

□ 

□ 

□ 


I 


►INTERRUPT LEVEL 
►RESERVED 
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Bits 0-2 Interrupt Level (LVL): 

These bits set the Interrupt level used by the Jaguar to assert a CommaixJ Complete 
Interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 Is allowed 
only when Interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

UNIT ADDRESS (2 BYTES) 

This field specifies the SCSI bus and the address of the target device. 


I 15 I U I 13 12 I 11 I 10 I 9 I 8 I 7 I 6 I 5 I 4 I 3 I 2 I 1 I 0 


>SCSI DEVICE ID 
-^■LOGICAL UNIT NUMBER 
-»>SCSI BUS SELECTION 
^RESERVED 


Bits 0-2 SCSI Device ID (SCSI ID): 

These three bits are the SCSI Bus ID (SCSI ID) of the specified device. 

Bits 3-6 Logical Unit Number (LUN): 

These bits describe the SCSI Logical Unit Number (LUN) of the specified device. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the Jaguar uses 
when executing the command. When the BUS bit is cleared to 0, the Jaguar executes 
the command over the primary SCSI bus (Port 0). When set to 1, it uses the secondary 
SCSI bus (Port 1). 

BItt 7-15 Reserved: 

These bits are reserved and must be deared to 0 by the host 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
lOPB for the Issue Bus Device Reset Message command: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an error code. A list of valid error codes Is provided in App^ix C. 
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ISSUE ABORT MESSAGE (Qx4E) 


This message is sent from the initiator to direct a targ^ to dear the present operation, if a iogicai unit 
has been identiTied, ali pending status for the issuing initiator from the affected iogicai unit is deared, and 
the target goes to the Bus Free phase. Pending data and status for other initiators is not deared. if a 
iogicai unit has not been identified, the target goes to the Bus Free phase. No status or ending message 
is sent for the operation. 

It is not an error to issue this message to a iogicai unit that is not currently performing an operation for 
the initiator. This command c^n be used to terminate an operation that is no longer required (killing a 
Format command to a drive, for example). 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the iOPB is as follows: 



NOTES: 

Reids set in bold cepitcri letters are returned vahjes. 

Al other values are host provided. Reserved fields 
must be cleared to 0 by the host 

Figure 5-22. Issue Abort Message IOPB 

The remainder of this section describes the function of each field in the Issue Abort Message IOPB. 

HOST-PROVIDED IOPB FIELDS 

The fdlowing information must be provided in the IOPB for the issue Abort Message command: 

COMMAND CODE (2 BYTES) 

This field must be set to 0x4E to execute the Issue Abort Message command. 
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COMMAND OPTIONS (2 BYTES) 

This field contains the options for this command. The bits are defined as follows: 


1 11 1 10 1 



□ 


J 1^INTERRUPT ENABLE 
-►RESERVED 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

NORMAL COMPLETION VECTOR/ERROR COMPLETION VECTOR 
(2 BYTES) 

These two bytes specify the VMEbus interrjpt vectors that the Jagi^r wi!! use to report 
normal command completion and command completion with error. 



U 1 13 1 12 1 11 1 10 1 9 1 8 1 7 

□ 

FFFl 

□ 


TERROR COMPLETION VECTOR 
♦NORMAL COMPLETION VECTOR 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

INTERRUPT LEVEL (2 BYTES) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 


1 15 1 W 1 

B 

B 

1 11 1 10 1 

9 1 8 1 

7 6 

□ 


□ 

□ 


♦INTERRUPT LEVEL 
♦RESERVED 
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Bits &-2 InterruiH Lsvel (LVU: 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
Interrupt on the VMEbus. Values of 0 thrcHjgh 7 are allowed, but a level of 0 is allowed 
only when Interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

UNIT ADDRESS (2 BYTES) 

This field specifies the SCSI bus and the address of the target device. 


15 


14 


13 12 11 10 9 


« 7 6 




2 10 


>SCSI DEVICE ID 
♦LOGICAL UNIT NUMBER 
♦SCSI BUS SELECTION 
♦RESERVED 


Bits 0-2 SCSi Device iD (SCSi ID): 

These three bits are the SCSI Bus ID (SCSI ID) of the specified device. 

Bits 3-5 Logical Unit Number (LUN): 

These bits describe the SCSI Logical Unit Number (LUN) of the specified device. 

Bft 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the Jaguar uses 
when executing the command. When the BUS bit is cleared to 0. the Jaguar executes 
the command over the primary SCSi bus (Port 0). When set to 1, it uses the secondary 
SCSI bus (Port 1). 

Bite 7-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned 
lOPB for the Issue Abort Message command: 

RETURN STATUS (2 BYTES) 

These two bytes hold the returned status of the command. Any non-zero value indicates 
an enDT code. A list of valid error codes is provided in App^ix C. 
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APPLICATION NOTES 


CHAPTER 6 

application notes 


This chapter contains application notes on the following topics: 

• Error Recovery Tools 

• Scatter/Gather Operations 

• Printer Port Operation 

. Offboard lOPBs 

• Considerations For Maximizing SCSI Synchronous Data Transfers 

ERROR RECOVERY TOOLS 

The Jaguar supports a variety of tools for dealing with two basic types of errors that can occur - SCSI 
device errors and controller errors. These error recovery tods are described in the following 
subsections. They are also documented where appropriate in the MACSI and lOPB sections of the 
manual (Chapters 3 and 5). 

SCSI DEVICE ERRORS 

A SCSI device error is defined to be the completion of a SCSI Command with a status byte of 
any value other than 0x0. Since a device may have many commands queued for it at the time 
an error occurs. SCSI device errors require some mechanism which allows the host to alter the 
order in which commands are being executed. The means provided by the Jaguar for this 
purpose are the Freeze/Thaw Work Queue and Abort Work Queue on Error options. 

NOTE 


: The Freeze/lhaw Wc»l< Oumm and Mxxit Work Ou^ue on Error 
: <)ptipn$ areitsjhiaMy work queoe 

caniKt be both Imzen ansd aborted It of efr€»; 


FREEZE/THAW WORK QUEUE AND ABORT WORK QUEUE ON ERROR 
FREEZE WORK QUEUE 

The Freeze Work Queue option provides a mechanism for freezing the state of 
a work queue when an error occurs. Error handling can be accomplished by 
passing one or more corrective commands to the device (such as Request 
Sense or a diagnostic command). Such commands must be issued to the 
device through the Master Command Entry via Work Queue 0. After the error 
handling has been completed, the work queue can be unfrozen. 
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The Freeze Work Queue option is enabied on a per queue basis when the 
queues are initialized. To enable the Freeze option for a given queue, set Bit 
2 (FZE) in the Work Queue Options field of the Initialize Work Queue lOPB. 


DlI 


13 12 11 

10 1 9 1 

s 

7 6 

□ 

□ 

E 

□ 

□□ 


.. -. . I L_#.aBORT enable 

-►RESERVED 

-►FREEZE WORK QUEUE 

-►RESERVED 

-►INITIALIZE WORK QUEUE 

(Word OxF In thThe initialize Work Queue lOPB) 

Rgure 6-1. Freeze Work Queue Option 

if enabied, the Freeze bit halts all further commands to a device when any 
Pass-Back status other than "goocr(status 0x00) is received from that device. 
In addition, a bit wiii be set in the Frozen Work Queues Register of the 
Configuration Status Block (see discussion below). 

Commands sent to a ' 'frozen"work queue will not be executed until the work 
queue is ' 'thawed,"as discussed below. Since the Freeze Work Queue option 
is intended to support error handling as a part of normal SCSI operations, 
queues are not frozen for controller errors. 

The Freeze Work Queue operation may be optionally changed using the 
initialize Controller command to freeze a work queue that has an active 
command upon receiving a SCSI reset The host wiii'' know"a Work Queue is 
frozen if it receives a command returned from the queue with a SCSI bus reset 
error status. It Is recommended that you enable this option when initializing 
the Jaguar. The default setting (i.e. do not freeze queue if command is returned 
with SCSI bus reset status) is provided for backward compatibility. 

NOTE 




s ❖ 


The FreS2e Vifork Qurae Pn IS noie enati^ed for Work 

beoatise ^ i$ dslitted lo have a This 1$ done to eiwa that only 

one error recovery process occurs at a Nowaveft ft possible diat a 

comrnaed irortr Wodc Queue a re<|uka error 

lake pfaCe^'the^SOSI Bos Beset and Rush Work Queue commands may always be 
Issued titfoui^the Wla^er Comtiaand Emiy to Work Queue 0 . For eft other 
comrnands Work Queue & has a length of one. 


FROZEN WORK QUEUES REGISTER. Located in the Configuration 
Status Block, this register identifies which work queues are frozen (if 
any). For Work Queues 1 to 14, if a given queue is frozen, then the 
corresponding bit position is set in the register. As noted before, Work 
Queue 0 cannot be frozen. The format of the register is repeated below 
for your reference: 
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WORK QUEUE 0 
UORiC QUEUE 1 
WORK QUEUE 2 
WORK QUEUE 3 
UORIC QUEUE 4 
UORK QUEUE 5 
WORK QUEUE 6 
UORK QUEUE 7 
UORK QUEUE 8 
UORK QUEUE 9 
UORK QUEUE 10 
UORK QUEUE 11 
UORK QUEUE 12 
UORK QUEUE 13 
UORK QUEUE 14 
RESERVED 


NOTE: Work Queue 0 cannot be frozen. Therefore, Bit 0 in the 
Frozen Work Queues Register is always cleared. 


Figure 6-2. Frozen Work Queues Register 

THAW WORK QUEUE. After the SCSI error condition has been 
cleared, the queue can be unfrozen by use of the Thaw bit in the 
MCSB. Execution of commands in the frozen queue is restarted by 
setting the least significant bit of the Thaw Work Queue Register. 


The frozen work queue is unfrozen by writing the appropriate work 
queue number into the upper byte of the Thaw Work Queue Register 
and then setting Bit 0 (THW) of that register. The Jaguar will dear Bit 
0 of the register to acknowledge the thawing of the work queue. The 
Thaw Work Queue Register is defined as follows: 




B 

B 

B 




□ 

0 

□ 

□ 

a 

□ 

□ 

□ 


J i^THAU UORK QUEUE 

-►RESERVED 

-►UORK QUEUE NUMBER 


(Word 0x4 in the Master Control/Status Block) 

Figure 6^. Thaw Work Queue Register 


ABORT WORK QUEUE ON ERROR 

The Abort Work Queue on Error option causes the Jaguar to abort all commands for 
that work queue unti a command is issued with the Abort Acknowledge bit set to 1 in 
the command's Queue Entry Control Register. This option is mutually exdusive with the 
freeze/thaw work queue feature described in the preceding subsectbns (a given work 
queue cannot be both frozen and aborted in the event of an error). 

The register is depicted below: 
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JL 


JL 


JL 


6 5 

I 

z 

z 

z 

z 


I . ■ -. J l^ABORT ENABLE 

-►RESERVED 

-►FREEZE WORK QUEUE 

-►RESERVED 

-►INITIALIZE WORK QUEUE 

(Word OxF In the Initialize Work Queue lOPB) 

Figure &4. Abort Work Queue On Error Option 

To enable Abort Work Queue on Error for a given work queue, set Bit 0 of the Work 
Queue Options field when you initialize the work queue. 

When a SCSI Device error occurs, the faling iOPB will be returned with the bad (non¬ 
zero) pass-back status. Ail other commands for that work queue wUI be returned with 
a Ccmmand Complete and Abort Queue set to 1 in the Command Response Word. This 
will continue until a command is found with the Abort Acknowledge bit set to 1 in the 
command's Queue Entry Control Register. This applies not only to the commands in the 
queue when the abort was activated, but to aii commands issuWi to that queue until the 
abort is acknowledged. 

REGISTERS FOR DETERMINING SCSI BUS STATUS 
AND LAST DEVICE ON BUS 

The Configuration Status Block contains two registers that provide the current SCSI bus status. 
Information in these registers can be used in conjunction with the Command Status inquiry and 
Bus Status Inquiry commands to determine the type of error that has occurred. 

ID OF LAST DEVICE CONNECTED TO SCSI BUS. The Last Device ID bytes contain 
the SCSI Bus IDs of the last devices connected to Port 0 and Port 1. The Bits 8-15 
contain the Primary SCSI Bus ID last connected. The Bits 0-7 contain the Secondary Bus 
ID last connected. 

SCSI BUS STATUS. The SCSI Bus Status field describes the status of the primary and 
secondary SCSI buses. Bits 8-15 contain the primary bus status. Bits 0-7 contain the 
status of the secondary bus (if used). Both bytes are images of the Fujitsu 87030 phase 
sense register. The format of that register is as foliows: 


I D7 I D6 I D5 I D4 I D3 I D2 I D1 I DO 


INPUT/OUTPUT 

-►CONTROL/DATA 

-HCSSAGE 


-►BUSY 


♦SELECT 

♦ATTENTION 

♦ACKNOWLEDGE 

♦REQUEST 


Figure 6-5. SCSI Bus Status Byte 


Each of the above signals is active high and corresponds to a specific SCSI bus signal. 
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The signals of most importance are BSY and SEL When BSY is a ' T, the Jaguar is connected 
to the SCSI bus. When SEL is a ' 1', it indicates that someone on the bus is attempting to select 
or reselect another device. For additionai Information on the signals, see Chapter 3. 

The SCSI Bus Status bytes are updated every 27 to 35msec. if the host is attempting to use this 
register to determine if the bus is hung, it should allow at least twice that period before making 
a decision. The actual amount of time required is dependent on the system. In general, it should 
be longer than the longest data transfer that might occur in the system.. 

ERROR RECOVERY COMMANDS 

Normal SCSI check condition errors are handled very simply via SCSI protocol. However, there 
are other types of errors from which it can be difficult to recover, such as errors due to a bad 
device or bug in the device driver program. 

The Jaguar provides three commands that can be used to determine what type of error has 
occurred without having to reset the board. They are: 

• The Command Status Inquiry lOPB reports the status of a command, identified 
by its command tag. 


The Bus Status Inquiry lOPB reports the state of all lOPBs requesting the SCSI 
Bus. It is used to find the command that is active on the bus at the time an 


iOPB timeout (discuss^ b^ow) has occurred. This is important because a 

command may cause another command to time out by blocking use of the 
SCSI bus by other devices. 


Cancel Command Tag removes an IOPB from the board. This command is 
provided for systems that can reset devices in error without resetting the SCSI 
bus. 


The above commands must be issued through the Master Command Entry to Work Queue 0. 
They may be issued at any time. 

For additional information on the above three commands, refer to the descriptions of the 
individual commands in Chapter 5. 

SELECTION AND COMMAND TIMEOUTS 

The Jaguar provides two features to signal unusual errors • selection timeout and command 
timeout Selection timeouts prevent the board from becoming locked up by trying to select a 
device that does not exist Command timeouts let the Jaguar notify the host that a user- 
programmed period of time has expired since a device was successfully selected. 

SELECTION TIMEOUT 

The selection timeout causes an IOPB to be terminated with an error status if a device 
does not respond to selection within the programmed period of time. The same value 
is used for ail devices. This value is specified in the Comroller Initialization Block. This 
timeout has a resolution of 1msec. 
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COMMAND TIMEOUT 

The command timeout is specified in the Initialize Controller command for Work Queue 
0. and in the Initialize Work Queue command for all other queues. All lOPBs issued 
through a work queue will use the timeout value specified for that work queue. 

• For Work Queue 0. the ninth word of the Controller Initialization Block 
is used for Work Queue 0 command timeouts. This field (word 9) is 
specified in increments of 256 msec. A value of 0 specifies no timeout. 

• The timeout values used for commands issued through Work Queues 
1 -14 are set when the queues are initialized. The tw^h word of the 
initialize Work Queue command contains the timeout value, which is 
specified in increments of approximately 256msec. Thus, each work 
queue (device) is able to run a unique timeout value. A value of 0 
specifies no timeout. 

To determine whether or not a command has timed out. the Jaguar measures how 
much time has elapsed between the successful completion of the selection phase to the 
completion of the command on the SCSI bus Onduding all disconnect periods). 

When a command timeout occurs, the Jaguar uses the Controller Error Interrupt and 
Vector to inform the host of the condition (see discussion in next subsection). This 
mechanism returns an error status without returning the lOPB that caused the error. 
Command timeouts invoke a Controller Error Vector Status Block with Error Code OxCl 
OOPB Timeout) in the Error Code field. If the command subsequently completes 
correctly, the o^inal lOPB will complete properly. The host may attempt to cancel the 
lOPB with the Cancel Command Tag lOPB. This will cause the Jaguar to terminate any 
further execution. The cancelled lOPB wHi not be posted back to the host. If the lOPB 
is active on the SCSI bus, the command cannot be cancelled and the host must either 
reset the SCSI bus or remove the device from the bus in some external manner. The 
command wSI then be posted with a Canceled Due to Bus Reset Status or Invalid 
Sequence error if it abruptly disconnects from the bus. 

The Jaguar must retain the lOPB which caused the timeout until the error condition has 
been cleared. This is necessary for two reasons. First, it allows the command to be 
completed if the device responds before error recovery can take place. Second, it 
prevents new commands from being issued from the queue until the host can handle 
the error condition. 

The usual technique for clearing errors is to issue a Reset SCSI Bus lOPB. This causes 
all of the commands currently active on that bus to be returned with a bus reset status. 
However, If your system is capable of removing individuai devices from the bus, you 
have an alternative to resetting the entire bus. The alternative is to remove the device 
in error and then issue a Cancel Command Tag lOPB to dear the lOPB which is waiting 
for a response from the removed device. 

If a command other than the command that timed out is active on the bus, it will be 
necessary to determine which command actually caused the error. There are a number 
of methods for determining the device in error. One technique is to have the host wait 
an additional period of time and check the board again to see that the state is the same 
as the previous check. This type of error is due either to incorrect programming or to 
a failed device and should be a rare occurrence. 
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CONTROLLER ERROR INTERRUPT AND VECTOR 

Controller errors are generated when an error occurs on the Jaguar that Is not related to a 
specific lOPB. This can be due to a variety of unusual board-related conditions. They may also 
be generated if the host issues an lOPB that lacks the proper information needed for the 
command to be processed normally. 


The interrupt level and vector used to signal such errors are set in the Controller Error 
Completion Level/Vector field of the Controller Initialization Block (see page ?). 

Controller errors will not generate an Interrupt If the controller error Interrupt level is 
cleared to 0 in the Initialize Controller lOPB. However, the board will report controllers 
errors to the Command Response Block even if Interrupts are not enabled. 

The Jaguar flags a controller error by setting the following bits in the Command Response Status 
Word: bit 7 (Status Change), bit 2 (Error), and bit 0 (Command Response Block Valid). Thus, the 
Command Response Status Word wQI read 0x0085 to signal the error. 

The Controller Error Vector enables the host to determine the source of a variety of errors. 
These include: 


• Errors associated with three bit-type commands (Start Queue Mode, Rush Work 
Queue, and Rush Queue and Report) 

at 

- iwi 

• lOPB timeout 

• A device has connected for which no lOPB exists 

• A device is requesting a data transfer of the opposite direction specified by the 
direction bit of the lOPB 

With the exception of the bit commands (Start Queue Mode, Rush Work Queue, and Rush 
Queue and Report), the above-listed error conditions cause the Jaguar to return a Controller 
Error Vector Status Block to the Command Response Block. This returned structure does not 
contain an lOPB. Instead, It contains an error code Indicating what has happened, along with 
information from the Command Queue Entry that was being executed when the error occurred 
(command tag, lOPB length, and work queue number). 
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CONTROLLER ERROR CODES 

The valid error codes which may be returned in word 6 of the above block are as 
foiiows: 

Table 6-1. Returned Error Codes For Controller Error Vector 


CODE 

DERNinON 

OxCO 

IOPB Type Error 

OxCI 

IOPB Timeout 

0x82 

A target has reconnected for which no IOPB exists. 

0X83 

A target is requesting rTKxe data to be transferred 
than the IOPB transfer count aNows. 

0x84 

Atarget is requesting a data transfer of the opposite 
direc^n specified in the direction bit of the IOPB 


NOTE 


These Error Codes wll not freeze the work queue. 


lOPB TYPE ERROR (OxCO). The Jaguar only supports type zero lOPBs. If the 
lOPB type field (bits 8 -11 in word 0 of the Command Queue entry) contains 
any value other than 0, the Jaguar will not " know^he overall structure of the 
lOPB and will therefore be unable to process it This en-or code indicates that 
the Command Queue entry contains invalid information. 

lOPB TIMEOUT ERROR (OxCI). An lOPB has timed out. The iOPB will remain 
active until It completes properly or is cancelled explicitly. The status of the 
IOPB may be inquired about with the Command Status Inquiry IOPB. With this 
error code, the Controller Error Vector Status Block Informatiw is valid. 

UNKNOWN DEVICE RECONNECTION (0x82). A SCSI device for which no 
current IOPB exists has re-selected the Jaguar. This code indicates that the 
ControUer Error Vector Status Block contains invalid information. 

DATA TRANSFER COUNT MISMATCH (0x83). Data counters have been 
exhausted, but the device is requesting more data than the current IOPB can 
transfer. With this error code, the Controller Error Vector Status Block 
information is valid. 

DATA DIRECTION ERRORS (0x84). The direction bit in the iOPB does not 
match the data transfer direct!^ requested on the SCSI bus. This error code 
indicates that the Controller Error Vector Status Block information is valid. 
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SUGGESTED ERROR RECOVERY SEQUENCE 

The following Is a suggested series of steps which may be taken by the host to recover from an 
error: 


• The host issues a Bus Status Inquiry to examine the status of commands 
executing on the bus. This enables the host to determine which command 
caused the error. Note that the command which timed out may not be one that 
is actuaJiy blocking the SCSI bus. The command that is most iikeiy in error will 
be the one active on the bus when the Bus Status inquiry is executed. 

• If a device is found to be connected on the SCSi bus indefiniteiy, there is no 
way to dear the error without resetting the bus. When this is the case, the host 
should Issue the Reset SCSI Bus lOPB through the Master Command Entry. All 
work queues with commarxls active on the bus wHI have those commands 
returned with a SCSI Reset Error status, and the work queue will be frozen (if 
the Freeze Work Queue on Reset option was selected in the initiaiize Controller 
Command). 

• The device which caused the error should either be removed or tested before 
restarting normal operation. The host can then reissue the commands and 
unfreeze the work queues. 

• For systems that have the ability to power down individual devices, the Rush 

Worir Queue cornmarKf us^ to prevent siew cxsmmands frorri being 

issued to the device after the error has been deared. it is not mandatory to 
flush the work queue before restoring the device, but be aware that the Jaguar 
will begin processing the commands from the queue as soon as: 1) the bus 
becomes available, and 2) the command that was being executed is deared. 

After powering down the device, the host should issue a Cancel Command Tag 
lOPB to dear the command which caused the error (i.e. the lOPB that was not 
completed by either a normal SCSI completion or by a SCSI reset). 


NOTE 




The RudiWog^CkjeueCominaixf {foes m]||lu^ : 

a nomia^ issmmaad sornpidiori, 2) a 
« OatKid CotfBmarid Taa 
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SCATTER/GATHER OPERATIONS 

The scatter/gather option allows contiguous peripheral data to be written to non-contiguous areas in 
system memory ("scatter*),or moved from non-contiguous blocks of system memory into contiguous 
ones ("gather*). Scatter/gather operations can only be performed with SCSI peripheral data. They 
cannot be used in conjunction with the printer port. 

By allowing multiple blocks of data to be transferred using only one command, scatter/gather frees the 
host from having to process multiple transactions when transferring non-contiguous blocks. This 
improves system performance by minimizing both the number of VMEbus interrupts and the number of 
bus transactions associated with common peripheral activity. 

To enable scatter/gather, set bit 1 of the Command Options word in the SCSI Pass-Through iOPB. 



ji 

z 

JL 

11 1 10 

I 

I 

I 

6 5 

I 

I 

I 

I 

3 


I . . I INTERRUPT ENABLE 

-►SCATTER/GATHER 

-►RESERVED 

(Word 0x1 in The SCSI Pass-Through ICPB) 

Figure 6-7. Command Options Word In The SCSI Pass-Through IOPB 

With scatter/gather enabled, the following three IOPB fields reference the Scatter/Gather Element List: 
1) Memory Type/TransferType/Address Modifier, 2) Buffer Address, and 3) Transfer Length. The Memory 
Type/Transfer Type/Address Modifier field has the same definition as it does for lOPBs which do not 
perform scatter/gather operations, except for the Link bit (Bit 15). For an explanation of this bit, see 
"Scatter/GatheUst Unking", below. 


15 1 14 1 13 

Qi] 

0 

1 

3 

8 7 

±Ll 

ih. 

2 

1 

0 


I . - .. .-. T — .- I ^INTERRUPT ENABLE 

-►SCATTER/GATHER 

-►RESERVED 

(Word 0x7 In The SCSI Pass-Through IOPB) 

Figure 6-8. Memory Type/Transfer Type/Address Modifier Field For Scatter/Gather 

Operations 

When scatter/gather Is used, words 0x8 - 0x9 of the IOPB contain the address of the scatter/gather list. 
If the Memory Type is 0x1 or 0x2, the value is interpreted as an address in system memory. 


14 1 13 1 12 1 11 1 10 1 9 

□□□a 

□B 

Bl 


SCATTER/GATHER LIST ADDRESS (4 BYTES) 


(Words 0x8 - 0x9 In The SCSI Pass-Through IOPB) 

Figure 6-9. Scatter/Gather List Address 

Words OxA - OxB contain the number of elements in the scatter/gather list. Valid entries in this field are 
1 to 64 (decimal). 


6-10 














APPUCATION NOTES 



(Words OxA - OxB In The SCSI Pass-Through lOPB) 
Rgure 6-10. Scatter/Gather Element Count 

Words OxC - OxD of the lOPB specify the sum of the individual element entry counts. 



(Words OxC - OxD Of The SCSI Pass-Through lOPB) 
Figure 6-11. Total Transfer Length For Scatter/Gather Operatbns 

NOTE 
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SCATTER/GATHER UST 

The scatter/gather option uses a list of elements to control the scatter/gather operation. Each 
element in the list specifies the byte count, address, memory type, and address modifier for each 
block of data In system memory that Is to be transferred by one SCSI Pass-Through command. 
Each element in the list is an 8-byte entry. The format is as follows: 




Figure 6-12. Scatter/Gather Element List Format 


This scatter/gather list can have from 1 to 64 elements. Using scatter/gather for lists with just one 
element, however, would be InefficienL 
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SCATTER/GATHER LIST UNKING 

To facilitate larger scatter/gather lists, any element in the scatter/gather list may contain 
a LINK bit When LINK (bit 15) Is set, the element structure wHI contain information that 
points to the next group of scatter/gather elements. An element that forms a link should 
have the foiiowing structure: 



LNK==1 


Figure 6-13. Link Element Structure 

The scatter/gather count field contains the number of elements in the next link to be 
gathered by the Jaguar. Valid Counts are 1 to 64. 

If scatter/gather list linking is used, all lists must be built at the time the lOPB is issued. 
In addition, the Total Transfer Count field in the ICPB must be contain the sum of ail 
individual data element counts, (it should not contain the link element counts.) 

PRINTER PORT OPERATION 

The Jaguar's printer port allows the host to transfer data to either a Centronics or Dataproducts short 
line interface printer. A version is also avaflable for use with a Dataproducts iongline interface. 

The printer port is a daughter card that attaches to the Jaguar. To execute a print command, the host 
issues an iOPB to Port 1 in much the same fashion as it would to a SCSI device. With the printer port 
installed. Port 1 is dedicated to the printer and cannot be used for SCSI transactions. 

When sending data to the printer, the Jaguar DMAs the printer data from host memory, transfers it to 
the printer via Port 1, and then returns a completion status. Printer status may be monitored 
asynchronously at any time by the host The host may also request that the Jaguar interrupt the host 
when a status change occurs. The printer port does not affect the normal operatton of the primary SCSI 
port (Port 0). 

VERIFYING PRINTER PORT INSTALLATION 

Once the host has initialized the Jaguar, it can verify that the printer port is installed by checking 
the Daughter Card ID field in Configuration Status Block. The printer port identification code 
(0x04) should be stored in this field. For information on setting the ports jumpers and 
termination, refer to the installation chapter. 
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INITIAUZING THE PORT 

The printer port requires a separate work queue. It wVI therefore be necessary to create a work 
queue for it using the Initialize Work Queue command, just as you would for a SCSI device. This 
work queue must be exclusively used for the printer port 

The first command to the printer work queue should be the Initialize Printer Port command (p. 
?). This command sets a variety of parameters, including: 1) the polarity of parity for 
Dataproducts printers, and 2) which printer status lines may generate a status change interrupt. 

The Initialize Printer Port command can be issued at any time to reset the printer port. The 
command is issued with the reset bit set to dear the printer port hardware. It should never be 
necessary to reset the hardware. The command may also be issued at any time to assert a 
buffer dear to the printer. Since the time required for holding this signal varies from printer to 
printer, the Jaguar will leave the line set untR the host issues another initialize Printer Port 
command with the bit deared. 

ISSUING PRINTER COMMANDS 

The Jaguar wS! queue printer commands (see Printer Port !QP8, Chapter 5} as recerved and 
work on each commarid in a RFC manner as the previous command completes. When the 
Go/Busy bit for a printer command is set, the command wll be copied from short I/O space into 
the internal printer port work queue. After the lOPB has been parsed for correctness, the data 
will be simultaneously DMA'd from system memory. When ail the data has been transferred to 
the printer, a copy of the lOPB modified with the current printer status and return code will be 
placed in the Command Response Block. 


HOST 

Initialize Controller lOPB 
Initialize Work Queue I0PB(8) 
Initialize Work Queue lOPB(s) 
Printer Port lOPBCs) 






<■ 




*■ 


*■ 




*■ 


JAGUAR 


Coamand Coaplete 
CoMnand(8) Conplete 
Comnand Complete 
CoRiiiend(s) Complete 


Figure 6-14. Example Of Printer Port Operation 

If the printer port is configured for the Dataproducts interface, the host may want to send special 
font or control characters to the printer using the Paper Instruction control line of the 
Dataproducts interface. The Jaguar supports this with the Paper instruction option in the lOPB. 
When the Paper Instruction option is set to 1, the Jaguar wHI transfer all of the data specified in 
this iOPB to the printer with the Paper Instruction interface signal active. Paper Instruction is only 
supported by Dataproducts printers. 
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STATUS REPORTING 


The printer status may be accessed in three ways from the Jaguar: 

• The state of the status lines is updated periodically in Configuration Status Block 
for asynchroTKHJS monitoring by the hc^ This status is stored in the Secondary 
Phase Sense/Printer Status field of the Configuration Status Block. For a 
Dataproducts interface, this byte is updated whenever Online. Ready, Parity 
Error, or Cable On changes state. For a Centronics interface, it is updated 
anytime Select. Fault, or Paper Empty changes state. For all interfaces, it is also 
up^ted approximately every 30 msec, as well as at the completion of a print 
command. 

• The second method is for the Jaguar to use the Controlier Normal Interrupt 
Vector specified in word 0x2 of the Controller Initialization Block. The host may 
select which status lines can generate an interrupt in the Initialize Printer Port 
iOPB. An interrupt is generated when an enabled status line (except parity) 
toggles either active or inactive. Parity error is only reported when it becomes 
active. The complete status word will be updated in Configuration Status Block, 
and a Command Response Block will be posted. This returned structure is 
shown in Chapter 5. 




The third method for accessing printer information is to issue a Printer Port 
IOPB with both the Maximum Transfer Length and the Printer Transfer Length 

Thie th« pjintsr poit to Update the Printer Status field 


of the IOPB and immediately return it as command completed. 


OFFBOARD lOPBs 

The Jaguar's MACS! interface is optimum for systems that have quick host access to 
the VME short i/0 space. In some systems, however, reading and writing data to/from this space can 
be quite time consuming. To speed up I/O in such systems, the Jaguar supp(^ a technique that 
enables the host to control the Jaguar with just two reads and two writes into the Jaguar's short I/O 
space for each command. This technique involves buBding offboard Command Queue entries. lOPBs, 
and an offboard Command Response Block. 


NOTE 



OVERVIEW 

In order to implement offboard lOPBs, you wBI need to allocate one or more blocks of system 
memory for sde use by these structures. The Jaguar's onboard Command Queue entries can 
then initialized to point to these fixed areas of memory. These pointers should not be 
changed once normal board operation has begun. 
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The host builds offboard lOPBs and Command Queue entries in this space. The only time it 
accesses the Jaguar's onboard Command Queue entry is to set the Go/Busy bit. 

The Jaguar then DMAs the offboard Command Queue entry/iOPB onboard and executes the 
command. Upon completion of this command fetch, the Jaguar dears the Go/Busy bit in the 
onboard Command Queue entry. 

BUILDING OFFBOARD lOPBs 

To build an offboard IQPB, set the Fetch Offboard lOPB bit (bit 4) in the Queue Entry Contrd 
Register. This is the first word of the onboard Command Queue entry. Setting this bit changes 
the purpose of the fields within the Command Queue entry, but it does not change the size of 
the Command Queue entry. 

When bit 4 is set, the Jaguar interprets the address in the onboard Command Queue entry as 
a pointer to a block of offboard memory consisting of an external Command Queue and one or 
more Command Queue entries. 

Offboard Command Queue entries and lOPBs have the same structure as their onboard 
counterparts, except that the IQPB Address field in an offboard Command Queue entry has no 
meaning. 

The format of an offboard Command Queue entry is shown below: 



Note the following important restrictions when buBding offboard Command Queue entries/IOPBs: 

• Each offboard Command Queue entry must be contiguous with its 
corresponding offboard IQPB in system memory (with the Command Queue 
entry residing in the lower portion of the block of memory). 

• Because a single DMA operation of the Jaguar cannot cross nonadjacent page 
boundaries, an offboard Command Queue entry and its correspoixJing IQPB 
cannot be spread across two nonadjacent pages in physical memory. 

The host may mix onboard and offboard commands by setting (or clearing) the FOB Bit in the 
Queue Entry Control Register of individual commands. However, this is not recommended for 
normal operation. It may be useful for handling errors or when operating the Jaguar in a 
standalone fashion. 
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INITIAUNG OFFBOARD COMMANDS 

To initiate a command, the host: 1) reads the Go/Busy bit of the next Command Queue entry 
to ensure that the entry is available, and 2) sets that same Go/Busy bit after it has assembled 
the offboard Command Queue entry and lOPB. 

If there is no external memory at the location specified in the Command Queue entry, the Jaguar 
will get a VME bus error (BERR*) when it tries to read the offboard Command Queue 
entry/IOPB. In this event, the Jaguar uses the default Error Level/Vector in the Controller 
initialization Block and places the Command Queue entry/IOPB at the normal Command 
Response Block (CRB) location in short I/O. 

OFFBOARD COMMAND RESPONSE BLOCK 


In order for the Jaguar to write a returned iOPB offboard, you need to designate a block of 
system memory for use as an offboard Command Response Block. Then, write a pointer to the 
block in the Controller Initialization Block, and execute the Initialize Controller command. Any 
non-zero value in the pointer field instructs the Jaguar to write returned lOPBs to the offboard 
address. 


Refer to the sections on the Command Response Block (Chapter 3) and Controller Initialization 
Block (Chapter 5) for additional informatioa 


Once you have initialized the Jaguar to write command responses to an offboard Command 

Response Block, all responses wii be wrluen to this structure unless a bus enor occurs during 

the write operation. 


POSTING COMMAND COMPLETION 

if the pointer to the external Command Response Block in the Controller Initialization 
Block is zero, then the Jaguar posts command response information in the Command 
Response Block section of its own short I/O space. 

Once it completes a command, the Jaguar DMAs the command response information 
into external memory and then generates a Command Complete Interrupt 

Before reading the command response information in its own memory, the host should 
first read error status in the Jaguar's onboard Command Response Block. (This 
information is inaccessible once the Jaguar's CRBV bit is cleared.) If an error occurs, 
the location of the Command Response Block will depend on the type of error. If the 
error is a SCSI device error, the Command Response Biock/retumed IOPB will be 
written offboard to the address specified in the Cc^roiler Initialization Block. 

On the other haixl, if the error status shows that a bus error (BERR*) occurred when 
attempting to move the information into the offboard Command Response Block, then 
the host can find the Command Response Block and IOPB in short I/O at the address 
specified in Word 6 of the Controller initialization Block (Command Response Block 
offset). 


After checking the error status, the host can respond to the interrupt by clearing the 
CRBV bit (Command Response Block Valid) in the Command Response Status Word 
of the Jaguar's onboard Command Response Block. 
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CONSIDERATIONS FOR MAXIMIZING SCSI SYNCHRONOUS DATA TRANSFERS 

Synchronous data throughput in a SCSI system can be significantiy improved by better matching the 
data transfer rates of the host adapter and SCSI devices. This is because SCSI devices support specific 
data transfer rates within the broad SCSI spectrum.^ When a synchronous data transfer takes place 
between two SCSI devices, these devices must negotiate between themselves to select a compatible 
transfer rate. If the devices have incompatible transfer rates, the result is significantly lower cable 
bandwidth. 

This paper describes the key factors determining the actual speed at which two SCSI devices will perform 
a synchronous data transfer (as opposed to the rated maximum speeds of the individuai devices). Since 
SCSI data transfer rates are negotiated in terms of nanoseconds per period instead of frequency, this 
discussion uses the SCSI transfer period to describe transfer rates. The SCSI transfer period is 
measured in 4ns increments. A resolution of 4 nanoseconds results in some strange and difficult to read 
numbers when converted to the equivalent frequency. Just remember that a smaller period means a 
higher frequency, and a larger perM means a lower frequency. 

NEGOTIATION PROCESS FOR SYNCHRONOUS TRANSFER RATES 

As noted above, the host adapter and target negcxiate the maximum transfer rate that may be 
used in data transfers. The negotiation process, which usually occurs the first time the host 
adapter communicates with a target, is essentially as follows: 

1. The host adapter tells the target the smallest transfer period at which the host 
adapter is able to operate. 

2. The target evaluates the received value. 

• if the proposed value is acceptable, the target returns it to the host 
adapter and the negotiation process is finished. 

• If the value is less than the target can handle, the target sends the host 
adapter the smallest transfer period at which it can function. The host 
adapter then accepts that as the correct value, and the negotiation is 
finished. 

Once a data transfw rate has been determined, all subsequent data transfers between the host 
adapter and target have a transfer period greater than or equal to the agreed-upon value. 

For example, consider a 4 Mbyte/sec. host adapter connected to a 4 Mbyte/sec. disk drive. A 
problem arises in that a 250ns period is not evenly divisible into the 4ns increments required by 
SCSI. Therefore, some devices express this value as 248ns, while others use 252ns. 

Assume that both devices use a 248ns period. In this case, the pair will communicate at 4 
Mbytes/sec., because both devices are allowed to transfer at a perM greater than the agreed- 
upon value. 


^The SCSI spedfication allows cable transfer rates ran^ng from roughly 1 Mbyte/sec. to 
5 Mbyte/sec., measured in 4ns increments. 
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On the other hand, if the host adapter uses 248ns and the drive uses 252ns, the cabie rate must 
be iess than 4 Mbytes/sec. The 4-nanosecond difference in periods is significant because 
devices do not actuaiiy support 4ns steps in transfer rates. The transfer rate is usually 
determined by some division of the oscliator which drives the SCSI controller of the device. 
Assuming that the SCSI controller is driven by a frequency that is twice the agreed-upon transfer 
rate, the next lower rate will be three times the input oscillator. In the example we are currently 
considering, this would mean that the host ad^er must operate at 375ns periods or 2.66 
Mbytes/sec. — considerably less than the 4 Mbyte/sec. maximum mte. 

The matching of device data transfer rates becomes particuiariy important when using the same 
cabie to interconnect targets that have different maximum sp^s. With this setup, the overall 
system transfer rate is determined by the transfer rates negotiated between the host adapter and 
each of the devices connected to it The table below lists a variety of "typical" SCSI drives and 
host adapters, along with their associated transfer rates. It Is followed by examples of the actual 
transfer rates that would be negotiated between different host adapters and drives in the table. 

Transfer Periods Of Example SCSI Host Adapters And Drives 


SCSI Device 

Maximum Transfer Rate of Device 

Transfer Rate if Target Device 
Cannot Transfer at Maximum Rate 

Drive 1 

212ns (4.72 Mhz) 

252ns (3.97 Mhz) 

Drive 2 

208ns (4.81 Mhz) 

248ns (4.03 Mhz) 

Host Adapter 1 

248ns (4.03 Mhz) 

375ns (2.66 Mhz) 

Host Adapter 2 

200ns (5.00 Mhz) 

300ns (3.33 Mhz) 

Host Adapter 3 

208ns (4.81 Mhz) 

312ns (3.21 Mhz) 

Host Adapter 4 

212ns (4.72 Mhz) 

318ns (3.14 Mhz) 


EXAMPLE 1: Host Adapter 1, Drive 1 Transfer Rate 252ns 

The host adapter requests 248ns. which the drive accepts as this is greater than the drive's 
minimum 212ns period. The actual transfer rate paced by the drive is 252ns. 


EXAMPLE 2: Host Adapter 1, Drive 2 transfer rate 248ns 

The host adapter requests 248ns, which the drive accepts as this is greater than the drive's 
minimum 208ns period. The actual transfer rate paced by the drive is 248ns. 


EXAMPLE 3: Host Adapter 2, Drive 1 transfer rate 300ns 

The host adapter requests 200ns, which the drive rejects as this is iess than the drive's minimum 
212ns period. The drive responds with 212ns. The host adapter must then transfer at its next 
greater period of 300ns. 
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EXAMPLE 4: Host Adapter 2, Drive 2 transfer rate 300ns 

The host adapter requests 200ns, which the drive rejects as this is less than the drive's minimum 
208ns period. The drive then responds with 208ns. The host adapter must then transfer at its 
next greater period of 300ns. 

The resulting transfer rates for the remaining combinations are as follows: 

• Host Adapter 3. Drive 1 transfer rate 312ns 

• Host Adapter 3, Drive 2 transfer rate 208ns 

• Host Adapter 4, Drive 1 transfer rate 212ns 

• Host Adapter 4, Drive 2 transfer rate 248ns 

The above examples show that it is possible to achieve similar performance from the two 
example drives with a 4 Mbyte/sec. hc^ adapter. However, if the speed of the host adapter is 
increased. It is not possible to achieve greater performance from both drives on the same cable. 
Some combinations actually hurt performance for some drives. 

This problem is the result of devices having a finite number of actual transfer rates while the 
SCSI specification allows a large number of legal values. It is therefore very important that the 
system integrator carefidiy choose devices with compatible transfer rates to achieve maximum 
performance. 
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APPENDIX A 
SPECIFICATIONS 


VMEbus SPECIFICATIONS 

DIB Master 
DTB Slave 
Requester 
Interrupter 

SCSI BUS SPECIFICATIONS 

Peripheral Data Rate 

POWER REQUIREMENTS 

Single-Ended V/SCSI 4210 Motherboard 

Single-ended V/SCSI 4210 Daughter Card 
Differential V/SCSi 4210 Motherboard 
Differential V/SCSI 4210 Daughter Card 

MECHANICAL (Nominal) 

Length 

Width 

Thickness 

Weight 

OPERATING ENVIRONMENT 

Temperature 
Relative Humidity 

FUSE 


A24. A32. D16, D32 
A16. D8. D16 
Any of R(0-3), Static 
Any of i(1-7), Dynamic 


Up to 4Mbytes/sec synchronous 
Up to 1.5Mbytes/sec asynchronous 


4.67 A typical @ +5V DC (+/- 5%) 
6.85 A maximum @ +5V DC (+/- 5%) 

0.75 A typical @ +5V DC (+/- 5%) 

1 A tngyinrtijm @ -f-5V DC (■{■/= 5%) 

5.27 A typical @ +5V DC (+/- 5%) 
7.62 A maximum @ +5V DC (+/- 5%) 

1.35 A typic^ @ +5V DC (+/- 5%) 
2.04 A maximum @ +5V DC (+/- 5%) 


233 mm 
160 mm 
20 mm 
.45 Kg 


0-55 degrees Centigrade 
10% - 90% Noncondensing 


The Jaguar has a 1-amp fuse (FI) used to protect the SCSi terminator power when provided by the 
Jaguar, its part number is Utdefu^ PN 251001. To determine the iocation of the fuse on the board, 
refer to the appropriate board iayout. 
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DIAGNOSTIC LEDs 

The Jaguar has 2 LED displays (LE01 and LED2) behind the panel that may provide useful diagnostic 
information. To locate the LEDs, refer to either Jaguar board layout (page ? or ?). The placement and 
use of the LEDs are identical for both board layouts. 

LED1: This single-LED display is green when the Board O.K. bit (bit 1 in the Master Status 
Register) is set. For a description of the Board O.K. bit. please refer to p. ?. if the LED 
turns red, one of the following conditions has occurred: 1) the board is being reset, or, 
2) the board has failed. 

LED2: This display consists of four LEDs, numbered 1 through 4. The meaning of the LEDs 
is as follows: 

LED: Explanation: 

0 VMEbus Busy (System) • This LED is active when the 

VMEbus BBSY* signal is active. 

1 VMEbus Busy (Jaguar) - This LED is active when the 

Jaguar is driving BBSY*. 

2 SCSI Busy (Port 0) - This LED is active when Port O's 

SCSI BSY* signal is active. 

3 This LED is not used. 


RELIABIUTY 

MTBF per MIL STD 217E 68,400 hours 
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APPENDIX B 

CONNECTOR PINOUTS AND CABLING 

OVERVIEW 



This appendix contains the connector pinouts and cabling information needed for various Jaguar 
configurations. The Mbies in this appendix are listed below, along with the page number on which each 
table appears: 

SCSI Ports 



• 

Table B-1. 

Single-ended SCSI port pinouts 

• 

Table B-2. 

Differential SCSI port pinouts 

Printer Port 



• 

Table B-3. 

Dataproducts Short Line printer cable pinouts 

• 

Table B-4. 

Dataproducts Long Line printer cable pinouts 

• 

Table B-5. 

Centronics printer cable pinouts 

PI and P2 Connectors 


• 

Table B-6. 

PI connector 

• 

Table B-T.f 

P2 connector, rows A and C. This table lists the SCSI signals 
provided by a single-ended motherboard with no daughter 
card. 

• 

Table B-8.t 

P2 connector, rows A and C. This table lists the SCSI signals 
provided by a differential motherboard with no daughter card. 

• 

Table B-9.t 

P2 connector, rows A and C. This table lists the SCSI signals 
provided by a single-ended motherboard with a single-ended 
daughter card. 

• 

Table B-IO.f 

P2 connector, rows A and C. This table lists the SCSI signals 
provided by a single-ended motherboard with a differential 
daughter card. 

• 

Table B-ll.f 

P2 connector, rows A and C. This table lists the SCSI signals 
provided by a differential motherboard with a single-ended 
daughter card. 

• 

Table B-12. 

P2 connector, row B. This table lists signals for motherboards 
which use P2 Row B only. 

fThese tables apply only to versions of the Jaguar which use P2 rows A and C. 
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DESCRIPTION OF SCSI CABLE 

All possible SCSI bus configurations on the Jaguar (single-ended vs. differential, and routed off P2. P3, 
or P4) require the same standard SCSI cable. A standard SCSI cable is either a 50-conductor fiat cable 
or a 25-signai twisted-pair cable. The cable is one-to-one. with 50-pin connectors on both ends. As per 
SCSI specifications, the cable can be up to 20 feet long (6 meters) for a single-ended SCSI bus and 82 
feet long (25 meters) for a differential one. 

Below is a list of sample part numbers which you may find to be useful in cabling your system. 
Interphase assumes no responsibility regarding the functionality of the parts listed below. If you 
need more information concerning the parts, contact the manufacturer directly. 


Component 
Flat Cable 
Connectors 

• End of cable connector 

• Without strain relief; no center key 

• With strain relief; no center key 

• Witf^jt strain relief; wth center key 

• Daisy Chain 

• Without strain reiieF, no center key 

• With strain relief; no center key 

• Without strain relief; with center key 


Sample Part No. 
3M-3365-50 


3M-3425-7000 
3M-3425-7050 
Dupont 6^00-290 


3M-3425-6000 
3M-3425-6050 
Dupont 66900-250 
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SINGLE-ENDED SCSI CABLE PINOUT 

The following pinout applies to ail Jaguar connectors which provide a singie-ended SCSI port, whether 
the port is routed off P2, P3, or P4. 

Table B-1. Single-Ended SCSI Port Pinouts 


Pin 

Nnonnic 

Pin 

Nnewmic 

1 

GNO 

2 

OBO- 

3 

GNO 

4 

DB1- 

5 

GND 

6 

DB2- 

7 

GND 

8 

DB3- 

9 

GNO 

10 

DB4- 

11 

GNO 

12 

DB5- 

13 

GND 

14 

DB6- 

15 

GND 

16 


17 

GND 

18 

DBP- 

19 

GNO 

20 

GND 

21 


22 

ww 

23 

GND 

24 

GNO 

25 


28 

TERHPWR 

27 

GND 

28 

GND 

29 

GND 

30 

GNO 

31 

GND 

32 

ATN- 

33 

GND 

34 

GND 

35 

GNO 

36 

BSY- 

37 

GND 

38 

ACK- 

39 

GND 

40 

RST- 

41 

GND 

42 

NSG- 

43 

GND 

44 

SEL- 

45 

GND 

46 

C/D- 

47 

GND 

48 

REQ- 

49 

GND 

50 

I/O- 


NOTE: If no signal is referenced, then the Jaguar does 
not use that pin. 
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DIFFERENTIAL SCSI CABLE PINOUT 

The following pinout applies to all Jaguar connectors which provide a differential SCSI port, whether the port 
is routed off P2, P3, or P4, 


Table B-2. Differential SCSI Port Pinouts 


Pin 

Nnemic 

Pin 

Nneaonic 

1 

SHIELD 

2 

GND 

3 

DBO«- 

4 

DBO- 

5 

DB1+ 

6 

DB1- 

7 

DB2+ 

8 

DB2- 

9 

DB3+ 

10 

DB3- 

11 

DB4+ 

12 

DB4- 

13 

DB5’^ 

14 

DB5- 

15 

DB6+ 

16 

DB6- 

17 

0B7+ 

1o 

DB7- 

19 

DBP+ 

20 

DBF- 

21 

DIFFSENS 

22 

GND 

23 

GND 

24 

GND 

25 

TERMPUR 

26 

TERNPUR 

27 

GND 

28 

GND 

29 

ATN+ 

30 

ATN- 

31 

GND 

32 

GND 

33 

BSY+ 

34 

BSY“ 

35 

ACK* 

36 

ACK- 

37 

RST4- 

38 

RST- 

39 

NSG4- 

40 

NSG- 

41 

SEL+ 

42 

SEL- 

43 

C/D+ 

44 

C/D- 

45 

RE04- 

46 

REQ- 

47 

I/0«- 

48 

I/O- 

49 

GND 

50 

GND 


B-4 








APPENDIX B 


DATAPRODUCTS PRINTER CABLING 


Table B-3. Cable Pinouts for P4 Connector to Dataproducts Short Line Printer 


4210 P4 

Dataproducts 
(Short Line) 

Functions 

4210 P4 

Dataproducts 
(Short Line) 

Function 

5 

19 

DATA 1 

11 

37 

RETURN 

7 

3 

RETURN 

42 

31 

BUFFER CLEAR 

9 

20 

DATA 2 

43 

15 

RETURN 

10 

4 

RETURN 

34 

12 

+5V (NOT SUPPLIED) 

1 

1 

DATA 3 

15 

22 

READY 

4 

2 

RETURN 

16 

6 

RETURN 

23 

41 

DATA 4 

12 

21 

ON LINE 

20 

40 

RETURN 

13 

5 

RETURN 

2 

34 

DATA 5 

18 

23 

DEMAND 

3 

18 

RETURN 

19 


RETURN 

29 

43 

DATA 6 

30 


PARITY ERROR 

26 

42 

RETURN 

31 


RETURN 

8 

36 

DATA 7 

24 


BOTTOM OF FORM 

5 

35 

RETURN 

25 


RETURN 

33 

28 

DATA 8 

27 


PAPER MOVING 

32 

44 

RETURN 

28 


RETURN 

36 

29 

DATA PARITY 

17 

39 

GROUND 

37 

13 

RETURN 

21 

24 

TOP OF FORM 

39 

30 

PAPER INSTRUCTION 

22 

8 

RETURN 

40 

14 

RETURN 

38 

46 

INTERFACE CONNECTED 

14 

38 

DATA STROBE 

35 

45 

INTERFACE CONNECTED RETURN 
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refercnceci, then that pin Is not used. 


Table B-4. Cable Pinouts for P4 Connector to Dataproducts Long Line Printer 


4210 P4 

Dataproducts 
(Long Line) 

Functions 

4210 P4 

Dataproducts 
(Long Line) 

Function 

6 

19 

DATA U 

11 


DATA STROBE- 

7 

3 

DATA 1- 

42 


BUFFER CLEAR* 

9 

20 

DATA 2 * 

43 


BUFFER CLEAR- 

10 

4 

DATA 2- 

34 


*5V (NOT SUPPLIED) 

1 

1 

DATA 3+ 

15 


READY* 

4 

2 

DATA 3- 

16 


READY- 

23 

41 

DATA 4+ 

12 

21 

ON LINE* 

20 

40 

DATA 4- 

13 

5 

ON LINE- 

2 

34 

DATA 5+ 

18 


DEMAND* 

3 

18 

DATA 5- 

19 


DEMAND- 

29 

43 

DATA 6^ 

30 


PARITY ERROR* 

26 

42 

DATA 6- 

31 


PARITY ERROR- 

8 

36 

DATA 7+ 

24 


BOTTOM OF FORM* 

5 

35 

DATA 7- 

25 


BOTTOM OF FORM- 

33 

28 

DATA 8+ 

27 


PAPER MOVING* 

32 

U 

DATA 8- 

28 


PAPER MOVING- 

36 

29 

DATA PARITY* 

17 


GROUND 

37 

13 

DATA PARITY- 

21 


TOP OF FORM* 

39 

30 

PAPER INSTRUCTION* 

22 


TOP OF FORM- 

40 

14 

PAPER INSTRUCTION- 

38 


INTERFACE CONNECTED 

14 

38 

DATA STROBE* 

35 

WM 

INTERFACE CONNECTED RETURN 


NOTE: If no signal is referenced, then that pin is not used. 
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DATAPRODUCTS CABLE DESCRIPTION 

Both short arxJ long line Dataproducts printer configurations require a 50-conductor fiat ribbon 
cable. Below is a list of samf^e part numbers which you may find to be useful in cabling your 
system. Interphase assumes no responsibility regarding the functionality of the parts listed 
below. If you need more Information concerning the parts, contact the part manufacturer 
directly. 


Component 


■S am pl e Part No - 


Rat Cable 


3M-3365-50 


Connectors 
• Jaguar End 

• Without strain relief; no center key 

• With strain relief; no center key 

• Without strain relief; with center key 

• Dataproducts End 


3M-3425-7000 
3M-3425-7050 
Dupont 66900-290 
T&B Ansley 609-50P* 


The oonneclortype needed for your specific Dataproducts printer may be different from that given above. Be sure 
to verify your printer^ connector requirements before making the cable. 


CENTRONICS PRINTER CABLING 


Table B-5. Cable Pinouts For P4 Connector to Centronics Printer 


4210 P4 

Centronics 

Function 

4210 P4 

Centronics 

Function 

6 

2 

DATA 1 

11 

19 

RETURN 

7 

20 


42 

31 

PRINTER INITIALIZE 

9 

3 

DATA 2 

43 

30 

RETURN 

10 

21 


34 

NU 

NOT USED 

1 

4 

DATA 3 

15 

32 

FAULT 

4 

22 


16 

NU 

NOT USED 

23 

5 

DATA 4 

12 

13 

SELECT 

20 

23 


13 

NU 

NOT USED 

2 

6 

DATA 5 

18 

10 

ACKNOULEDGE 

3 

24 

RETURN 

19 

28 

RETURN 

29 

7 

DATA 6 

30 

12 

PAPER ENTRY 

26 

25 


31 

NU 

NOT USED 

8 

8 

DATA 7 

24 

NU 

NOT USED 

5 

26 


25 

NU 

NOT USED 

33 

9 

DATA 8 

27 

11 

BUSY 

32 

27 


28 


RETURN 

36 

NU 

NOT USED 

17 


NOT USED 

37 

NU 

NOT USED 

21 


NOT USED 

39 

NU 

NOT USED 

22 


NOT USED 

40 

NU 

NOT USED 

38 


NOT USED 

14 

1 

DATA STROBE 

35 


NOT USED 
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PI CONNECTOR 


Table B-€. PI Connector Signal Descriptions (All Versions) 


Pin 

Row A Signal Mnemonic 

Row B Signal Mnemonic 

Row C Signal Mnemonic 

1 

000 

BBSY* 

008 

2 

001 

BCLR* 

009 

3 ' 

002 

ACFAIL* 

010 

4 

003 

BGOIN* 

Oil 

5 

004 

BGOOUT* 

012 

6 

005 

BG1IN* 

013 

7 

006 

BG10UT* 

014 

8 

007 

BG2IN* 

015 

9 

GNO 

BG20UT* 

GNO 

10 

SYSCLK 

BG3IN* 

SYSFAIL* 

11 

GNO 

BG30UT* 

BERR* 

12 

0S1* 

BRO* 

SYSRESET* 

13 

OSO* 

BR1* 

LUORO* 

14 

URITE 

BR2* 

AN5 

15 

GNO 

BR3* 

A23 

16 

OTACIC 

AMO 

A22 

17 

GNO 

AMI 

A21 

IS 

AS^ 

AfQ 

A20 

19 

GNO 

AM3 

A19 

20 

lACK 

GNO 

A18 

21 

lACKIN* 


A17 

22 

lACKOUT* 


A16 

23 

AM4 

GNO 

A15 

24 

A07 

IRQ7* 

A14 

25 

A06 

IRQ6* 

A13 

26 

A05 

IRQ5* 

A12 

27 

A04 

IRQ4* 

All 

28 

A03 

IRQ3* 

A10 

29 

A02 

IRQ2* 

A09 

30 

A01 

IRQ1* 

AOS 

31 



+12V OC 

32 

♦5V OC 

+5V OC 

+5V OC 


NOTES: If no signal Is referenced, then the Jaguar does not use that pin. A denotes 
an active low signal. 
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SCSI SIGNALS ON P2 CONNECTOR 

The tables on the next five pages list the SCSI signals which are routed to P2 by the following Jaguar 
configurations: 


• A single-ended motherboard with no daughter card. 

• A differential motherboard with no daughter card. 

• A single-ended motherboard with a single-ended daughter card. 

• A single-ended motherboard with a differential daughter card. 

• A differential motherboard with a single-ended daughter card. 

To determine the full P2 pinout of your version of the Jaguar, combine the SCSI signal description for your 
motherboard/daughter card configuration with the Row B VMEbus signals shown in table B-12. 

As noted prevbusly in this manual, if you have a differential daughter card installed on a differential 
motherboard, only the primary SCSI bus (Port 0) can be routed off P2. 
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The following tatsle lists the SCSI signals routed to P2 rows A and C by a single-ended motherboard with 
no daughter card. (Assumes the motherboard uses P2 rows A and C.) 

Table B-7. P2 Connector SCSI Signal Descriptions (Single-Ended Motherboard, No Daughter Card) 



NOTE: Signals from the single-ended motherboard (Port 0) are set in type 
These signals are routed off the P4 connector on the P2 adapter 
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The following table lists the SCSI signals routed to P2 rows A and C by a differential motherboard with no 
daughter card. (Assumes the motherboard uses P2 rows A and C.) 

Table B-8. P2 Connector SCSI Signal Descriptions (Differential Motherboard. No Daughter Card) 


Pin 

Row A Signal Mnenonic 

Row B Signal Mnemonic 

Rou C Signal Mnemonic 

1 

m 



2 

i/th 



3 



mm 

Di 




5 



mi 

6 

NS8> 



7 



H 

8 




tm 



mm 

10 




11 



mm 

12 

nmsm 



13 

m- 



14 



mi* 

15 

m- 



16 




17 

ms 



18 



Hi 

19 




20 



wmm 

21 




22 




23 




24 




25 




26 

Km 



27 

m 



28 

am 



29 




30 




31 

m 



32 





NOTE: Signals from the differential motherboard (Port 0) are set in l^fPj type. 
These signals are routed off the P3 connector on the P2 adaj^er! 
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The following table lists the SCSI signals routed to P2 rows A and C by a single-ended motherboard with a 
single-ended daughter card. (Assumes the motherboard uses P2 rows A and C.) 


Table B-9. P2 Connector SCSI Signal Descriptions (Single-Ended Motherboard, Single-Ended Daughter Card) 


Pin 

Row A Signal Hnenonic 

Row B Signal Mnemonic 

Row C Signal Mnemonic 

1 

I/O- 



2 

REQ- 



3 

C/D- 


GND 

tm 

SEL- 


Hi 

5 

NSG- 


GND 

6 

RST- 


B 

B 

ACK- 


GND 

8 

BSY- 



Di 

GND 


GND 

10 

ATN- 



11 

GND 


GND 

12 

TERNPUR 



13 

GND 


GND 

14 

DBP- 


GND 

15 

DB7- 


B 

16 

DB6* 


GND 

17 

-1«5^- - 


Hi 

18 

DB4- 


GND 

19 

DB3- 



20 

DB2- 



21 

DB1- 



22 

DBO- 


GND 

lEI 



GND 

24 

GND 



25 

GND 


m-* 

26 

GND 


la^ 

27 

GND 


m*- 

28 

GND 



29 

GND 


m- 

30 

GND 



31 

GND 



32 

GND 




NOTES: Signals from the single-ended motherboard (Port 0) are set in 

type. These signals are routed off the P4 connector on the P2 adapter. 

Signals from the single-ended daughter card (Port 1) are set in regular 
(non-shaded) type. These signals are routed off the P3 connector on 
the P2 adapter. 
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The following table lists the SCSI signals routed to P2 rows A and C by a single-ended motherboard with a 
differential daughter card. (Assumes the motherboard uses P2 rows A and C.) 


Table B-10. P2 Connector SCSI Signal Descriptions (Single-Encied MotherboarcJ, Differential Daughter Card) 


Pin 

Row A Signal Hnemonic 

Row B Signal Mnemonic 

Row C Signal Mnemonic 

1 

GND 


I/O- 

2 

I/O- 



3 

REQ- 


l/O*^ 

la 

C/D- 


IS 

5 

SEL- 


REQ^ 

B 

MSG- 


H 

7 

RST- 


C/D+ 

8 

ACK- 


SI 

9 

BSY- 


SEL+ 

10 

GND 



11 

ATN- 


MS&i- 

12 

TERNPWR 


Hi 

13 

DBP- 


RST+ 

14 

DB7- 


ACiC+ 

15 

DB6- 


11 

16 

DB5- 


BSY+ 

17 

DB4- 


mm 

18 

DB3- 


ATN+ 

19 

DB2- 



20 

DB1- 


TERMPUR 

21 

DBO- 


mm. 

22 

GND 


DIFFSENS 

23 



DBP+ 

24 

DB7+ 



25 

DB64- 


mz*-. 

26 

DB54' 


1X86* 

27 

DB44- 



28 

DB34^ 



29 

DB2-*- 



30 

DBU 


682!* 

31 

DB0+ 


681- 

32 



nso** 


NOTES: Signals from the single-ended motherboard (Port 0) are set in 

type. These signals are routed off the P4 connector on the P2 adapter. 

Signals from the differential ciaughter card (Port 1) are set in regular 
(non-shaded) type. These signals are rout^ off the P3 connector on 
the P2 adapter. 
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The following table lists the SCSI signals routed to P2 rows A and C by a differential motherboard with a single- 
ended daughter card (Assumes the motherboard uses P2 rows A and C.) 

Table B-11. P2 Connector SCSI Signal Descriptions (Differential Motherboard, Single-Ended Daughter Card) 


Pin 

Row A Signal Hnemonic 

Row B Signal Mnemonic 

Row C Signal Mnemonic 

1 

mm 


I/O- 

2 

11 


REQ- 

3 

w 



4 

■ 


C/D- 

5 



B 

6 



SEL- 

7 

m* 


wm 

8 



MSG- 




pm 

10 



RST- 

11 



mm. 

12 



ACK- 

13 



IK 

14 

mt* 


Pm 

15 



BSY- 

16 




iPi 

17 

m- 


ATN- 

18 

pasSi^ 



iii 

19 




20 



Hm 

21 



TERMPUR 

22 

pm 



23 



mm 

24 



DBP- 

25 



DB7- 

26 



DB6- 

27 

■ 


DB5- 

28 



DB4- 

29 



0B3- 

30 



DB2- 

31 



DB1- 

32 



OBO- 


NOTES: Signals from the differential motherboard (Port 0) are set in 

type. These signals are routed off the P3 connector on the P2 adapter. 

Signals from the single-ended daughter card (Port 1) are set in regular 
(non-shaded) type. These signals are routed off the P4 connector on 
the P2 adapter. 
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P2 CONNECTOR ROW B ONLY VERSION 

Table B-12. P2 Connector for Motherboards which only Use P2 Row B 


Pin 

Row A Signal Mnemonic 

Row B Signal Miemonic 

Row C Signal Mnemonic 

1 


♦5V DC 


2 


GNO 


3 




Di 


A24 


5 


A25 


wmm 


A26 


7 


A27 


8 


A28 


9 


A29 


10 


A30 


11 


A31 


12 


GMO 


13 


♦5V DC 


14 


D16 


1? 


D17 


16 


D18 


17 


D18 


18 


D20 


19 


D21 


20 


D22 


21 


D23 


22 


CND 


23 


D24 


24 


D25 


25 


D26 


26 


D27 


27 


D28 


28 


D29 


29 


D30 


30 


D31 


31 


GND 


32 


*5y DC 



NOTE: if no signal is referenced, then the Jaguar does not use that pin. 
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APPENDIX C 
ERROR CODES 


The Jaguar Controller Error Codes field returns information pertaining to the operation of the lOPB 
returned in the Command Response Block. Statuses have been separated into five groups: 
MACSI/Controller, General, Error Recovery, VME, and SCSI errors. The V/SCSI 4210 Jaguar controller 
status definitions are reported in hexadecimal format 

MACSI/CONTROLLER ERROR CODES 

HEX CODE DESCRIPTION 

0x00 GOOD STATUS: 

The controller has completed the command and no errors were detected. The 
Pass-Back status field contains the Pass-Through status. 

0x01 QUEUE FULL 

The work queue specified for this command is full and cannot receive another 
entry. The command is not executed and is moved directly to the Command 
Response Block with this status set The queue can receive another entry after 
a currently active command has completed or if the queue is flushed. 

0x02 WORK QUEUE INfflAUZATION ERROR: 

The work queue specified has not been initialized. The command is not 
executed and is moved directly to the Command Response Block with this 
status set The Work Queue should be initialized with an Initialize Work Queue 
Command. 

0x03 FIRST COMMAND ERROR: 

The first command sent to the board was not an Initialize Controller command. 
The board should be reset &n6 the first command issued should be the Initialize 
Controller command In order to set up the MACS! operating parameters. 

0x04 COMMAND CODE ERROR: 

The command field contains an invalid command type. Either a SCSI lOPB type 
or a Control iOPB type must be specified. 

0x05 QUEUE NUMBER ERROR: 

The work queue number specified in the Command Queue entry is invalid. Valid 
work queue numbers are 0 to 14. 

0x06 QUEUE ALREADY INfflAUZED: 

The work queue specified to be initialized has already been initialized. To 
re-initiaiize a queue, set the IWQ bit in the options field. 
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0X07 

0x08 

0x09 

OxOB 

GENERAL ERROR 

HEX CODE 
0x10 

0x11 

0x12 

0x13 

0x14 

0x15 


QUEUE UNINITIAUZED: 

An lOPB was issued to a work queue that has not been Initialized. Work queues 
must be initialized with operating parameters before usage. 

QUEUE MODE NOT READY: 

The Start Queue Mode bit was set before the Initialize Controiier Command was 
issued. The Initialize Controiier Command should be the first board operation 
after power up to configure the MACSI interface. 

COMMAND UNAVAILABLE: 

The command specified has not been implemented in the current firmware. 
INVAUD BURST COUNT: 

This error indicates that the requested burst size in the Controller Initialization 
Block is odd. or is greater than 256. 

CODE INFORMATION 

DESCRIPTION 

RESERVED RELD ERROR: 

A reserved field in the lOPB has non-zero data in it. 

RESET BUS STATUS: 

The SCSI Reset lOPB has executed successfully and generated a Reset on the 
bus. 

SECONDARY PORT UNAVAILABLE: 

An lOPB has been issued to the secondary port (Port 1), but the port is not 
installed. 

SCSI ID ERROR: 

The SCSI device ID requested is the Jaguar’s own device ID. All devices on the 
bus require unique SCSI IDs. 

SCSI BUS RESET STATUS: 

The command could not execute because the SCSI bus is held in the reset 
state. This may be caused by an un-powered device on the bus. improper 
termination, or an inverted cable. 

COMMAND ABORTED BY RESET: 

The command has been aborted due to a SCSI reset condition received during 
execution of the command. 
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0x16 

0x17 

0x18 

VMEbus ERRORS 

HEX CODE 

0x20 

0x21 

0x23 

0x24 

0x25 


0x26 


PAGE SIZE ERROR: 

The page size specified in the Page Size field of the Controller Initialization 
Block (words OxD - OxE) is invalid. For most applications, this field must be 0. 
Contact Interphase for special applications. 

INVAUD COMMAND TAG: 

Command tags must be non-zero for successful searches. 

BUSY COMMAND TAG: 

Command is on the bus. 


DESCRIPTION 
VMEbus BUS ERROR: 

This error indicates that a bus error occurred during the DMA transfer of the 
data to or from the buffer or the bus. 

VMEbus TIMEOUT: 

This error indicates that bus acquisition v^s not completed within the 
programmed timeout period. This error is typically caused by a nonexistent 
address or address m^ifier in the lOPB. 

VMEbus ILLEGAL ADDRESS: 

For 16-bit transfers, the starting address of the VMEbus buffer must fail on a 
word boundary (even address). For 32-bit transfers, the starting address of the 
VMEbus buffer must fall on a long word boundary (multiple of 4). 

VMEbus ILLEGAL MEMORY TYPE: 

An Hiegal memory type has been specified. 

ILLEGAL COUNT SPEaRED: 

The maximum transfer length specified is not an even number. All transfer 
counts must be even since the controller can only perform word or long word 
transfers. If an odd count is to be transferred across the SCSI bus, the count 
specified in the maximum length field must be padded by ' 1'to round up the 
VMEbus transfer count to a word or long word multiple. 

VMEbus FETCH ERROR: 

A VMEbus error occurred during an offboard lOPB fetch. 
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0x27 

0x28 

0x29 

0x2A 

0x2B 

0x2C 

0x2D 

0x2E 

SCSI ERRORS 
HEX CODE 
0x30 

0x31 

0x32 


VMEbus FETCH TIMEOUT: 

A VMEbus timeout occurred on an offboard iOPB fetch. 

VMEbus POST ERROR: 

A VMEbus error occurred on an offboard Command Response Block post. 
VMEbus POST TIMEOUT: 

A VMEbus timeout occurred on an offboard Command Response Block post. 
VMEbus ILLEGAL FETCH ADDRESS: 
illegal address on an offboard IOPB fetch. 

VMEbus ILLEGAL POST ADDRESS: 

Illegal address on an offboard Command Response Block post. 

VMEbus SCATTER/GATHER FETCH: 

VMEbus error on scatter/gather list fetch. 

VMEbus SCATTER/GATHER TIMEOUT: 

VMEbus timeout error on scatter/gather list fetch. 

INVAUD SCATTER/GATHER COUNT: 

An invalid number of scatter/gather elements has been specified. Valid element 
counts are 1 to 64. 


DESCRIPTION 

SCSI SELECTION TIMEOUT ERROR: 

The selection phase of the SCSI device has failed. The error may occur due to 
an incorrect Target ID. 

SCSI DISCONNECT TIMEOUT ERROR: 

A disconnected device has not re-selected the board in the timeout period. This 
may be caused by a hardware error, or a command that may take a very long 
period of time to execute. 

ABNORMAL SCSI SEQUENCE: 

The SCSI operation did not complete successfully due to a hardware error or 
an abnormal operation sequence. 
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0x33 SCSI DISCONNECT ERROR: 

An invalid SCSi bus sequence has been detected. This usually indicates a 
device has disconnected without either issuing the disconnect or command 
compiete message. 

0x34 SCSI TRANSFER COUNT EXCEPTION: 

The SCSI Transfer Count of Data did not match the count specified in the 
maximum count length field. The amount of data actually transferred on the 
SCSI bus wRI be returned in the maximum count length field. This status may 
not be considered an error for commands that intentionally allocate more buffer 
than the SCSI command uses. 

0x35 SCSI PARITY ERROR: 

A parity error occurred during the Informatbn Transfer phase on the SCSI bus. 

SCATTER/GATHER ERRORS 

HEX CODE DESCRIPTION 

0x40 ILLEGAL SCATTER/GATHER COUNT 

Odd byte count in scatter/gather list 

0x41 ILLEGAL SCATTER/GATHER MEMORY TYPE 

Illegal memory type in scatter/gather list. 

0x42 ILLEGAL SCATTER/GATHER ADDRESS 

illegal address in scatter/gather list 

ERROR HANDLING CODES 

HEX CODE DESCRIPTION 

0x50 READ/WRITE BUFFER COUNT ERROR: 

Buffer count is too large. 

0x51 ILLEGAL READ/WRITE: 

Cant execute because of offboard Command Response Block. 

0x80 FLUSH ON ERROR IN PROGRESS: 

This status is set when the lOPB is flushed because an error condition has 
occurred and the work queue has the abort enable option set This causes all 
queued lOPBs to be flushed until the abort acknowledge has been received. 
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0x81 FLUSH WORK QUEUE STATUS: 

The queued iOPB is being flushed in response to a Rush Work Queue 
Command. 

0x82 MiSSING COMMAND: 

A device has reselected the 4210 for which there is no currently pending 
command. 

0x83 COUNTER EXHAUSTED: 

The transfer counter has exhausted but more data is being requested by the 
target device. 

0x84 DATA DIRECTION ERROR: 

A data phase is being requested opposite of the direction set in the IOPB. 

PRINTER PORT ERRORS 

HEX CODE DESCRiPTiON 

0x90 PRINTER STATUS CHANGE: 

A printer port status change interrupt is being posted. 

0x91 PRINTER COUNT TOO SHORT: 

The value in the Maximum Transfer Length field must be greater than or equal to the 
Printer Transfer Length field. 

0x92 BAD DATA LENGTH RELD: 

The Maximum Transfer Length field is set to 0, but the Printer Transfer Length field is 
not 

0x93 PRINTER UNAVAILABLE: 

The printer port is not installed or is not initialized. 

0x99 SCATTER/GATHER SELECTED FOR PRINTER PORT: 

Scatter/gather iTKXle is not avaHabie for use with the printer port. 

OTHER ERRORS 

HEX CODE DESCRiPTiON 

OxCO BAD IOPB TYPE: 


The IOPB type field does not match a currently supported iOPB type. 
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0XC1 


iOPB TIMEOUT ERROR 

The IOPB has timed out due to some type of serious error. 
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APPENDIX D 

MACS! DATA STRUCTURES 


/* 

* 

* 

*/ 


VJ.struct.h : V/SCSI 4210 Jaguar HACSI header. 


typedef unsigned char BYTE; 
typedef unsigned char U6YTE; 
typedef unsigned short UUORD; 
typedef unsigned int UINT; 


/* 8 bit unsigned 
/* 8 bit unsigned 
/* 16 bit unsigned 
/* 32 bit unsigned 


V 

•/ 


typedef unsigned int ULONG; 

/* 32 bit unsigned */ 


/**************** Master Control Stetus Block (MCSB) ***************** 

**/ 

typedef struct mcsb { 

/* Master control/status Block 

*/ 

UWORO 

incsb_MSR; 

/* Master status register 

V 

UWORD 

mcsb^NCR; 

/• Master Control register 

*/ 

UWORD 

incsb_IQAR; 

/* Interrupt on Queue Available Reg 

*/ 

UWORD 

mcsb^QHDP; 

/* Queue head pointer 

*/ 

UWORD 

nicsb_THAW; 

/* Thaw work Queue 

*/ 

UWORD 

mcsb_RES0; 

/* Reserved word 0 

*/ 

UWORD 

incsb_RESl; 

/* Reserved word 1 

*/ 

UWORD 

incsb_RES2; 

/* Reserved word 2 

•/ 

> VJ_MCSB; 




^********** 

***** Controller 

Initialization Block CCIB)*************** 

**/ 

typedef struct cib { 

/* Controller Initialization Block 

*/ 

UWORD 

cib NCQE; 

/* Nunber of Conaand Queue Entries 

*/ 

UWORD 

cib'BURST; 

/* DMA Burst count 

V 

UWORD 

cib“NVECT; 

/* Norml Conpletion Vector 

* j 

UWORD 

ciblEVECT; 

/* Error Completion Vector 

*/ 

UWORD 

cib”PID; 

/* Primary SCSI Bus ID 

V 

UWORD 

cib SID; 

/* Secondary SCSI Bus ID 

*/ 

UWORD 

cib”CRBO; 

/* Command Response Block Offset 

*/ 

ULONG 

cib"sELECT; 

/* Selection timeout in milli-second 

*/ 

ULONG 

cib~UQ0 TIMEOUT; 

/* Work Q 0 timeout in 256msec ticks 

*/ 

ULONG 

cib"VME“TIMEOUT; 

/* ViCbus Timeout 0 « 100msec timeout 

V 

ULONG 

cib“PAGE SIZE; 

/* Page size * RESERVED for most applications 

UWORD 

cib'CRB ADRMOD; 

/* Offboard Coanand Response Block memtype 

UINT 

cib'CRB^ADDRESS; 

/* Offboard Command Response Block address 

UWORD 

cib“CRB”ERTFLAGS; 

/* Reserved words 

V 

> VJ CIB; 




/**************** comsand Queue Entry (CQE) ***************** 

**y 

typedef struct cqe { 

/* Command Queue Entry 

*/ 

UWORD 

cqe QECR; 

/* Queue Entry Control Register 

*/ 

UUORD 

cqeJOPB.ADDR; 

/* I0P6 Address 

V 

ULONG 

cqe CTAG; 

/* Command Tag 

*/ 

UBYTE 

cqe*lOPB LENGTH; 

/* lOPB Length 

V 

UBYTE 

cqeluORK.QUEUE; 

/* Work Queue Number 

*/ 

UUORD 

cqe*RES0; 

/* Reserved word 

*/ 

> VJ CQE; 





*/ 

*/ 
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/ ************** IQPB Format 
typedef struct iopb < 

UUORD 
UlORD 
UWORD 
UUORD 
UBYTE 

ubyte 

UUORD 
UUORD 

UWORD 
ulong 
ulong 
ulong 
UWORD 
UUORD 
UUORO 
^ VJ^IOPB; 


(IOPB) 


CMD; 

/* 

IOPB Command code 

*/ 

iopb"0PTI0N; 

/* 

IOPB Option word 

*/ 

iopbISTATUS; 

/* 

IOPB Return Status word 

*/ 

iopb RESO; 

/* 

IOPB Reserved word 

*/ 

iopb"NVCT; 

/* 

IOPB Normal completion Vector 

V 

iopb EVCT; 

/* 

IOPB Error completion Vector 

*/ 

iopb'LEVEL; 

/* 

IOPB Interrupt Level 

*/ 

i<^_RES1; 

/* 

IOPB Reserved word 

*/ 

iopb"AD0R; 

/* 

IOPB Address type and modifier 

*/ 

iopb"BUFF; 

/* 

IOPB Buffer Address 

*/ 

iopb"LENGTH; 

/* 

IOPB NaX'Transfer Length 

*/ 

iopb"SG_LENGTH; 

t* 

IOPB Length in bytes of S/G request */ 

opb"RES4; 

t* 

IOPB Reserved word 

*/ 

opb"UHIT; 

f* 

IOPB Unit address on SCSI bus 

V 

opb"sCSIC6]; 

/• 

IOPB SCSI words for pass through 

*/ 


/**************** 
^ypedef struct crb i 


^JWC«iO 

ulong 

ubyte 

UBYTE 

UWORD 

Vj__sopB 

VJ_CR8= 


Comtnand Response Block (CRB) ***** 

/* Coamand Response Block 


crb CRSW; /* 
crb'RESO; /* 
crb'CTAG; /* 
crb"IOPB LENGTH; /* 
crb MORK"queUE; /* 
crb RESIT /* 
crb IOPB; /* 


Command Response Status Word 

Reserved t#ord 

Command Tag 

IOPB Length 

Work Queue Nudaer 

Reserved word 

Returned IOPB 


V 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 

V 


/***’************* 
typedef struct csb € 
csb_RESO; 


Configuration Status Block (CSB) 


t«YTE 

char 

UUO^ 

ubyte 

char 

UUORD 

ubyte 

char 

UMOIO) 

Char 

uworo 

UWORD 

UWORD 

ubyte 

Ubyte 

Ubyte 

Ubyte 

ubyte 

Ubyte 

Ubyte 

Ubyte 

ubyte 

ubyte 

. „ UluT 


csb RESI; 

csb'PCOOED); 

csb RES2; 

csb~RES3; 

csb"PVAR; 

csb"RES4; 

csb"RES5; 

C8b"FREV[3]; 

C8b"RES6; 

csb"FDATE[8]; 

csb"RES7; 

csb~BSIZE; 

csb"RES8[2]; 

csb"PID; 

csb"SID; 

csb"PRI SLCTD; 

csb"SEC"SLCTD; 

Csb"PRrPSNS; 

csb"SEC"PSNS; 

csb"RSRW9; 

csb DB ID; 

CSb^RSRVDIO; 

csb"DIP SU; 

csb"FR2 "bITS; 


/* Configuration Status Block 120 bytes*/ 

/* Reserved word 

*/ 

/* Reserved byte 

*/ 

/* Product Code 

*/ 

/* Reserved word 

*/ 

/* Reserved byte 

*/ 

/* Product Variation 

*/ 

/* Reserved word 

*/ 

/* Reserved byte 

*/ 

/* Firmware Revision level 

*/ 

/* Reserved word 

*/ 

/* Firmware Release date 

*/ 

/* Reserved word 

*/ 

/* Buffer size in Kbytes 

*/ 

/* Reserved word 

*/ 

/* Primary SCSI Bus ID 

*/ 

/* Secondary SCSI Bus ID 

*/ 


/* 

/* 

f* 

/* 

/* 

I* 

f* 

/* 

/* 


Primary Port (Port 0) Last Device Selected */ 
Secondary Port (Port 1) Last Device Selected */ 


Primary Port (Port 0) Phase Sense Shadow 
Secondary Port (Port 1) Phase Sense Shadow 
Reserved byte */ 

Daughter Board ID */ 

Reserved byte */ 

Software Dip Switch Setting */ 

Show Which Queues are Frozen V 


*/ 

*/ 


Initialize Work Queue Command Format (UQCF)* 


tlWORD 

^JWCNID 

^-*WORD 

*-*UlORD 

^-•BYTE 

•-•^YTE 

^-■WORD 

•**WORD 


ict wqcf { 

/* Initialize Work Queue Command Format*/ 

wqcf_CMD; 

/* Command Normally (0x42) 

*/ 

wqcf"0PTI0N; 

/* Coaaiand Options 

*/ 

wqcf "status; 

/* Return Status 

*/ 

wqcf"RES0; 

/* Reserved word 

*/ 

wqcf"NVCT; 

/* Normal Completion Vector 

*/ 

wqcf"EVCT; 

/* Error Completion Vector 

*/ 

wqcOLVL; 

/* Interrupt Level 

*/ 

wqcf_GROUP; 

/* Nuaber of commands to group together*/ 
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UUORO 

uqcf RES1[7]; 

/* Reserved words 

*/ 

UUORD 

uqcf'uORICQi 

/* Uork Queue Nunber 

*/ 

UUORO 

uqcf'uOPT; 

/* Uork Queue Options 

V 

UUORO 

wqcf'SLOTS; 

/* Nunber of slots in the Uork Queues 

*/ 

UUORO 

uqcf'PRIORITY; 

/* Priority Level 

*/ 

UINT 

HC|cf“TIMEOUT; 

/* Coanand Tine-Out for this Queue 

*/ 

UUORO 

uqcf'SEC UQ; 

/* Secondary Uork Queue Nunber nirror 

*/ 


J VJ_WQCF; 


/**************** OFFBOARD COMHAMD QUEUE ENTRY/IQPB ******************/ 
typedef struct offbd^iopb C 
VJ_C(£ copycqe; 

VJ^IOPB copyiopb; 

>OFFBD lOPB; 


/****************** Scatter/Gather Descriptor block 
typedef struct C 


UUORO 

sg^bcount; 

/* Byte Count for transfer 

*/ 

ULONG 

sg3>addr; 

/* Physical Address 

V 

UUORO 

sg_addm^; 

/* lOPB Address type and modifier 

*/ 


> VJ_SG; 
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APPENDIX E 


APPENDIX E 

ACRONYMS USED IN THIS MANUAL 


AA 

Abort Acknowledge 

AE 

Abort Enable 

AQ 

Abort Queue 

BOK 

Board OK 

BUS 

SCSI Bus Selection 

CC 

Command Complete 

CIB 

Controller Initialization Block 

CNA 

Controller Not Available 

CQ 

Command Queue 

CQA 

Command Queue Entry AvaBabie 

CQE 

Command Queue Entry 

CRB 

Command Response Block 

CRBV/CI 

Command Response Block Valid/Clear Interrupt 

CRSW 

Command Response Status Word 

CSS 

Controller Specific Space 

DFT 

Default 

DIR 

VMEbus Transfer Direction 

ER 

Error 

EX 

Exception 

EXT 

Extended Addressing Enable 

FLQ 

Rush Queue 

FLQR 

Rush Queue and Report 

FZE 

Freeze Enable 

GO 

Go/Busy 

HPC 

High Priority Command 

HUS 

Host Usable Space 

IE 

Interrupt Enable 

IL 

Interrupt Level for the Interrupt on Queue Available 

lOPB 

Input/Output Parameter Block 

IQAR 

Interrupt on Queue Available Register 

IQEA 

Interrupt on Queue Entry Available 

IQHE 

Interrupt on Queue Half Empty Enable 

IV 

Interrupt Vector for Interrupt on Queue Available 

IWQ 

Initialize Work Queue 

LUN 

Logical Unit Number 

LVL 

Interrupt Level 

MACSI 

Multiple Active Command Software Interface 

MCE 

Master Command Entry 

MCR 

Master Control Register 

MCSB 

Master Control/Status Block 

MSR 

Master Status Register 

MT 

Memory Type 

PIP 

Primary Bus (Port 0) Command in Progress 

QECR 

Queue Entry Control Register 

QFC 

Queue Rush Complete 

QMS 

Queue Mode Started 


E-l 
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RES 

Reset Controller 

RPT 

Report Rushed Commands 

RSRV 

Resen/ed 

SCSI ID 

SCSI Device ID 

SFEN 

SYSFAIL Enable 

SG 

Scatter/Gather 

SIP 

Secondary Bus (Port 1) Command In Progress 

SQM 

Start Queue Mode 

THW 

Thaw Work Queue 

TT 

Transfer Type 





UPDATE 


TO 

V/SCSI 4210 User’s Guide 
Revision UG-0770-000-X0F, Rev. B 


ADDENDUM - May 25, 1989 

ERROR RECOVERY OF HRMWARE REVISION XOW TO XAD AND BEYOND 

Three new features have been added to firmware revisions XOW through XAD, which 
improves software interface for error recovery: 

• Work Queue Zero’s length has been redefined to allow error recovery of 
commands in Work Queue Zero. 

• Located in the Controller Specific Space, a register for each port has been added 
to report the last SCSI ID selected. 

• Additionally, a register has been added for each port to periodic ally report the 
SCSI bus status, also, located in the Controller Specific Space. 

These changes do not affect compatibility with earlier revisions. 


Work Queue Zero Length Change 

Work Queue Zero is defined to have a length of one. This is done with the intention 
that only one error recovery process can occur at a time. However, it is possible that a 
command from Work Queue Zero may require error recovery itself. To allow this to 
take place, certain commands may always be issued through Work Queue Zero. SCSI 
Bus Reset and Flush Work Queue commands may always be issued through Work 
Queue Zero. For all other commands Work Queue Zero will still have a length of one. 


Controller-Specific Space Changes 

New SCSI status has been added to the Controller-Specific Space of the Jaguar 4210. 
This information is useful for determining the status of the SCSI bus during error 
conditions. 
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Address offset 0x7AC contains two bytes that describe the last device ID 

connected on both the primary and secondary ports. The Bits 8-10 contain the Primary 

Bus ID last coimected. The Bits 0-2 contain the Secondary bus last coimected. 


Primary 


Secondary 



Reserved 


r 


Secondary Bus ID 


Primary Bus ID 


- Reserved 


Update Figure 1. Bus Offset 0x7AC 


Address offset 0x7AE contains two bytes that describe the SCSI status. The SCSI status 
bytes are updated approximately every 32 msec. They are used to determine the SCSI 
bus status during error conditions. Bits 8-15 contain the Primary bus status. Bits 0-7 
contain the Secondary bus status. 

The bus status byte for each bus is an image of the Fujitsu 87030 Phase Sense register. 

The format of that register is as follows. 


Primary Secondary 



Update Figure 2. Phase Sense Register Offset 0x7AE 


Each of these signals are active high. They each correspond to a signal on the SCSI 
bus. For a complete description of each signal, see the SCSI specification or the 87030 
user’s guide. 

The signal of most importance is BSY. When BSY is a 1, the Jaguar is connected to the 
SCSI bus. This signal is updated approximately every 32 msec so a long period of time 
should be allowed to pass with no responses fi-om the Jaguar before this byte is 
considered valid. 
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ADDITIONAL HARDWARE OPTIONS FOR PB-0773-A08-000 

This version of the PCB (Update Figure 3. Optional Jumper and Switch Setting) 
supports jumper selectable selection of early or standard release of the VME busy* 
signal. A software option switch is also added to select features previously implemented 
with special firmware versions. 

This artwork has a different oscillator jumpering scheme to support possible fumre 
options. These jumpers are set at the factory and should not be changed. 

JAl This jumper connects Terminator Power to the SCSI Bus. 

JAl is located next to P4, the secondary SCSI Bus 
Connector. This jumper is not installed at the factory. 

FI - FUSE This fuse protects the SCSI Terminator Power when provided 

by the Jaguar. The fuse is a Littlefuse PN 251001. 

SCSI TERMINATION RNl, RN2, and RN3 provide termination for the primary 

SCSI Bus when installed. When the Jaguar is not at one end 
of the cable, these resistor SIPs should be removed. 
Termination is installed at the factory. 

JAIO This jumper selects early or standard release of the VME 

busy* signal when the Jaguar is operating as a master. No 
jumper installed selects early release. The jumper is not 
installed at the factory. 

The jumpers listed below are for factory use and should not be changed. 

JA2,JA3,JA4,JA5 These four jumpers are for oscillator testability. JA2, JA3, 

and JA5 must be in place for proper Jaguar operation. 

JA6 This jumper is used to select the EPROM size. It is set at 

the factory and should not be moved. 

1- 2 64K byte EPROM ( 27512 ) 

2- 3 32K byte EPROM ( 27256 ). This is the factory setting. 
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Update Figure 3. Optional Jumper and Switch Settings 
(Board layout of Artwork PB-0773-A08-000) 
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Default Operation - Switch Location UK2 

This switch (refer to Update Figure 3. Optional Jumper and Switch Settings) 
presently provides the selection of two firmware options. Default operation of 
the board is provided by setting switch 1 - 8 to the "ON" position. 

Switch 1 This switch when set to the "ON" position causes the SCSI bus to be reset 
after the Jaguar has been power-up or reset. Setting this switch to the 
"OFF’ position disables this SCSI reset. This option may be useful in 
some multi-host adapter systems. 

Switch 2 This switch when set to the "ON" position causes the Jaguar to remove 
the VME SYSFAIL* signal immediately after coming out of reset. When 
set to the "OFF' position the Jaguar will not clear this signal until the 
board has completed an extended self test and is ready to accept 
commands. The extended self-test takes approximately four seconds to 
execute. 

Switch 3-8 These switches are reserved and should be set to the "ON" position to 
ensure compatiblity with future firmware releases. 

Base Address Switch - Location UN3 

To clarify the information for optional switch settings which determine the base address 
of the 4210 (refer to page 75). Page 75 of the manual incorectly states that Switch 8 of 
switch block SWl controls supervisor/user access. In actuality, Switch 9 on SWl 
controls this selection. Note, however, that Figure Al. on Page 75 is correct. The 
following chart has been supplied to assist in setting the base address: 
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Update Table 1. Base Address Switch Settings for the 4210 


Switch Setting Switch Setting 


Address 

8 

7 

6 

5 

4 

Address 

8 

7 

6 5 4 

0000 

0 

0 

0 

0 

0 

8000 

F 

~Q 

0 0 0 

0800 

0 

0 

0 

0 

F 

8800 

F 

0 

OOF 

1000 

0 

0 

0 

F 

0 

9000 

F 

0 

0 F 0 

1800 

0 

0 

0 

F 

F 

9800 

F 

0 

OFF 

2000 

0 

0 

F 

0 

0 

AOOO 

F 

0 

F 0 0 

2800 

0 

0 

F 

0 

F 

A800 

F 

0 

F 0 F 

3000 

0 

0 

F 

F 

0 

BOOO 

F 

0 

F F 0 

3800 

0 

0 

F 

F 

F 

B800 

F 

0 

F F F 

4000 

0 

F 

0 

0 

0 

COOO 

F 

F 

0 0 0 

4800 

0 

F 

0 

0 

F 

C800 

F 

F 

OOF 

5000 

0 

F 

0 

F 

0 

DOOO 

F 

F 

0 F 0 

5800 

0 

F 

0 

F 

F 

D800 

F 

F 

OFF 

6000 

0 

F 

F 

0 

0 

EOOO 

F 

F 

F 0 0 

6800 

0 

F 

F 

0 

F 

E800 

F 

F 

F 0 F 

7000 

0 

F 

F 

F 

0 

FOOO 

F 

F 

F F 0 

7800 

0 

F 

F 

F 

F 

F800 

F 

F 

F F F 


NOTE: 0 - ON/GLOSED 
F - OFF/OPEN 
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"C" Language Structure of the Controller Specific Space. 

The following is a ‘C’ language structure that describes the Controller Specific Space of 


the Jaguar 4210: 




r 

* VJ struct.h : V/SCSI 4210 Jaguar MACSI header. 

* 

* / 


/ 

typedef unsigned char 

BYTE; 

/* 8 bit unsigned 

V 

t)^def unsigned char 

UBYTE; 

/* 8 bit unsigned 

V 

typedef unsigned short 

DWORD; 

/* 16 bit unsigned 

V 

typedef unsigned int 

DINT; 

/* 32 bit unsigned 

V 

typedef unsigned int 

DLONG; 

/* 32 bit unsigned 

V 

^****************** Scatter/Gather Descriptor block *•♦**♦•♦♦••*•***♦*••♦•**/ 


typedef struct { 




U^A'ORD 

sg bcount; 

/* r' __ *._ 

/ oyic v^uuiii lOr Lidjuaici 

A / 

/ 

ULONG 

sg_paddr; 

/* Physical Address 

V 

DWORD 

sg_addrmod; 

/* lOPB Address type and modifer 

V 

} VJ SG; 




y**************** Master Control Status Block (MCSB) *•*****•*♦••*♦**••♦/ 


typedef struct mcsb { 


/* Master control/Status Block 

V 

DWORD 

mcsb MSR; 

/* Master status register 

7 

DWORD 

mcsb MCR; 

/* Master Control register 

V 

DWORD 

mcsb IQAR; 

/* Interrupt on Queue Available Reg 

V 

DWORD 

mcsb QHDP; 

/* Queue head pointer 

7 

DWORD 

mcsb THAW; 

/* Thaw work Queue 

7 

DWORD 

mcsb RESO; 

/* Reserved word 0 

7 

DWORD 

mcsb RESl; 

/* Reserved word 1 

7 

DWORD 
} VJ MCSB; 

mcsb_RES2; 

/* Reserved word 2 

7 


*************** Controller Initialization Block (CIB)*****************/ 


f 

typedef struct cib { 


-\-/ f 

/* Controller Initialization Block 

7 

DWORD 

cib_NCQE; 

/* Number of Command Queue Entries 

7 

DWORD 

cib BDRST; 

/* DMA Burst count 

7 

DWORD 

cib_NVECT; 

/* Normal Completion Vector 

7 

DWORD 

db EVECT; 

/* Error Completion Vector 

7 

DWORD 

db"PID; 

/* Primary SCSI Bus ID 

7 

DWORD 

db__SID; 

/* Secondary SCSI Bus ID 

7 

DWORD 

db CRBO; 

/* Command Response Block Offset 

7 

DLONG 

db’SELECT; 

/* Selection timeout in milli-second 

7 

DLONG 

db_WQO_TIMEODT; 

/* Work Q 0 timeout in 256 ms ticks 

7 

DLONG 

db VME TIMEODT; 

/* VME llmeout 0 = 100ms timeout 

7 

DLONG 

db PAGE SIZE; 

/* Page size on controller in bytes 

7 

DWORD 

db"CRB ADRMOD; 

/* Off board CRB memtype 

7 

DINT 

db-CRB-ADDRESS; 

/* CRB off board address 

7 

DWORD 

db'CRB ERTFLAGS; 

/* Reserved words 

7 

} VJ CIB; 
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^**************** Command Queue Entry (CQE) *********m*********^ 


typedef struct cqe { /* Command Queue Entry */ 

UWORD cqe QECR; /* Queue Entry Control Register */ 

UWORD cqe lOPB ADDR; /* lOPB Address */ 

ULONG cqe CTAG; /* Command Tag */ 

UBYTE cqe’lOPB LENGTH; /‘ lOPB Length */ 

UBYTE cqe“WQRK^QUEUE; /* Work Queue Number */ 

UWORD cqe RESO; /* Reserved word •/ 

} VJ CQE; 


y**************** jQpg Format (lOPB) 
typedef struct iopb { 

UWORD iopbCMD; 

UWORD iopbOPTION; 

UWORD iopb STATUS; 

UWORD iopbRESO; 

UBYTE iopb_NVCT; 

UBYTE iopb_EVCr; 

UWORD iopb_LEVEL; 

UWORD iopbRESl; 

UWORD iopbADDR; 

ULONG iopb_BUFF; 

ULONG iopb LENGTH; 

ULONG iopb^SG LENGTH; 

UWORD iopb_R]^; 

UWORD iopb_UNIT; 

UWORD iopb_SCSI[6]; 

} VJ IOPB; 


******************* j 

f* IOPB Command code */ 

/* IOPB Option word */ 

/* IOPB Return Status word */ 

/* IOPB Reserved word */ 

/* IOPB Normal completion Vector */ 

j* IOPB Error completion Vector */ 

/* IOPB Interrupt Level */ 

/* IOPB Reserved word */ 

/* IOPB Address t^ and modifer */ 

/* lOFB Buffer Address */ 

/* IOPB Max-Transfer Length * f 

/* IOPB Length in bytes of S/G request */ 
/* IOPB Reserved word ♦/ 

/• IOPB Unit address on SCSI bus */ 

/* IOPB SCSI words for pass through */ 


**************** Command Response Block (CRB) ******************* 


typedef struct crb { /* Command Response Block */ 

UWORD crb_CRSW; /* Command Response Status Word */ 

UWORD crb~RES0; /* Reserved word •/ 

ULONG crb~CTAG; /* Command Tag */ 

UBYTE crb lOPB LENGTH; /* IOPB Ungth */ 

UBYTE crb WORK QUEUE; /* Work Queue Number ♦/ 

UWORD crb RESl; /* Reserved word */ 

VJ IOPB crb IOPB; /* Returned IOPB •/ 

} VJ_CRB;'’ 



V/SCSI 4210 UPDATE 9 



Configuration Status Block (CSB) ♦♦♦♦••**♦♦*•*♦*•*•• / 


typedef struct csb { 


/* Configuration Status Block 120 bytes 

V 

DWORD 

csb RESO; 

/* Reserved word 

V 

UBYTE 

csb RESl; 

/* Reserved byte 

V 

char 

csb_PCODE[3]; 

/* Product Code 

V 

DWORD 

csb RES2; 

/* Reserved word 

V 

DBYTE 

csb"RES3; 

/* Reserved byte 

V 

char 

csb_PVAR; 

/* Product Variation 

V 

DWORD 

csb RES4; 

/* Reserved word 

V 

DBYTE 

csb RES5; 

/* Reserved byte 

V 

char 

csb_FREV[3]; 

/* Firmware Revision level 

V 

DWORD 

csb RES6; 

/* Reserved word 

V 

char 

csb FDATE[8]; 

/* Firmware Release date 

V 

DWORD 

csb_RES7; 

/* Reserved word 

V 

DWORD 

csb BSIZE; 

/* Buffer size in Kbytes 

V 

DWORD 

csb RES8[2]; 

/* Reserved word 

V 

DBYTE 

csbPID; 

/* Primary Bus ID 

V 

DBYTE 

csb SID; 

/* Secondary Bus ED 

V 

DBYTE 

csbPRISLCTD; 

/* Primary Port Last Device Selected 

* / 

/ 

DBYTE 

csb SEC SLCTD; 

/* Secondary Port Last Device Selected 

A / 

7 

DBYTE 

csb PRI PSNS; 

/* Primary Port Phase Sense Shadow 

V 

DBYTE 

csb SEC PSNS; 

/* Secondary Port Phase Sense Shadow 

V 

DBYTE 

csb_RSRVD9; 

/* Reserved byte 

7 

DBYTE 

csb DB ID; 

/* Daughter Board ID 

V 

DBYTE 

csb RSRVDIO; 

/* Reserved byte 

V 

DBYTE 

csb DIP SW; 

/* Software Dip Switch Setting 

V 

DINT 

csb FRZ BITS; 

/* Show Which Queues are Frozen 

V 

} VJ CSB; 




^itiiii************** 

Initialize Work Queue Command Format (WQCF)***********/ 


typedef struct wqcf { 


/* Initialize Work Queue Command Format 

V 

DWORD 

wqcf_CMD; 

/* Command Normally (0x42) 

V 

DWORD 

wqcf OPTION; 

/* Command Options 

V 

DWORD 

wqcf_STATDS; 

/* Return Status 

V 

DWORD 

wqcf_RES0; 

/* Reserved word 

7 

DBYTE 

wqcf_NVCT; 

/* Normal Completion Vector 

7 

DBYTE 

wqcf^EVCT; 

/* Error Completion Vector 

7 

DWORD 

wqcf ILVL; 

/* Interrupt Level 

7 

DWORD 

wqcf GRODP; 

/* Number of commands to group together 

7 

DWORD 

wqcf_RESl[7]; 

/* Reserved words 

7 

DWORD 

wqcf WORKQ; 

/* Work Queue Number 

7 

DWORD 

wqcfWOPT; 

/* Work Queue Options 

7 

DWORD 

wqcf"SLOTS; 

/* Number of sl<^ int the Work Queues 

7 

DWORD 

wqcf"PRIORITY; 

/* Priority Level 

7 

DINT 

wqcf TIMEOUT; 

/* Command Time-Out for this Queue 

7 

DWORD 

wqcf SEC WQ; 

/* Secondary Work Queue Number mirror 

7 


} VJ WQCF; 


y**************** OFF BOARD CQE/IOPB *********************************^ 

typedef struct offbd_iopb { 

VJ_CQE copycqe; 

VJ lOPB copyiopb; 

jOFFBDJOPB; 
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V/SCSI 4210 ERROR RECOVERY STRATEGY 
OVERVIEW 

Normal SCSI check condition errors are handled very simply by the SCSI protocol. 
There are other types of errors though that can be difficult to recover from. These 
errors may be due to a bad device or possibly due to programmer error. The 4210 
Error Recovery Tools reduces the possibility of ever having to reset the Jaguar to 
recover from errors. To allow recovery from conditions that cause the controller to stop 
executing commands, methods of determining the state of the Jaguar and recovery 
commands are provided. 

The first step in recovering from unusual errors is knowing they exist. The Jaguar 
provides two features to signal errors. The first, selection timeouts, generally require no 
further error handling but they prevent the board from becoming locked up by trying to 
select a device that does not exist. The second, command timeouts, lets the Jaguar 
notify the host that a user programmed period of time has expired since a device was 
successfully selected. 

SELECTION TIMEOUT 

The selection timeout causes an lOPB to be terminated with an error status if a device 
does not respond to selection within the programmed period of time. The same value is 
used for all devices. This value is specified in the controller initialization block. This 
timeout has a resolution of 1ms. 

COMMAND TIMEOUT 

The command timeout value is set for each Work Queue. All commands from the 
Work Queue use that timeout value. The timeout value is used from the successful 
completion of the selection phase until the completion of the command on the SCSI bus. 
This timeout includes all disconnect periods. The resolution is in increments of 
approximately 256ms. 

The Jaguar notifies the host of the lOPB timeout by use of the Controller Error 
interrupt. This interrupt will be used to return error status without returning the lOPB 
that caused the error. Bit 7 of the Command Response Status Word allows the allows 
the host to determine the source of the error. Also data returned in the command 
response block has been defined to specify the type of error that has occurred. 

ERROR CLEARING 

The Jaguar must retain an lOPB that causes a command timeout to occur until the error 
condition has been cleared. Normally the host will simply issue a Reset SCSI Bus lOPB 
to the bus the command timeout on. This will cause all of the commands currently 
active on that bus to be returned with a bus reset status. 
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CANCEL COMMAND TAG lOPB 

Some systems may find it undesirable to reset the entire bus however. If a system has 
the ability to individually remove a device from the bus a method is required to clear 
the lOPB waiting for a response from the removed device. The error is cleared by 
issuing a Cancel Command Tag lOPB for the lOPB in error. 

ERROR DETERMINATION 

Once the host is aware that an error exists it will be required to identify the type of 
error so that the correct error recovery can take place. Two commands are provided 
that assist the host in determining the state of the Jaguar. 

These are: 

• Command Status Inquiry 

Reports the status of a command, identified by its command tag. 

• Bus Status Inquiry 

Reports the state of all lOPBs requesting the SCSI Bus. 

In addition to the above commands a register has been added to the controller specific 
space of the Jaguar that provides the SCSI bus status. These commands and the bus 
status can be used in an error condition to determine the state of the Jaguar. 

Proposed Error Recovery Sequence 

The host becomes aware of an error conditon, either from an lOPB or other host 
generated timeout. The host may then execute a recovery sequence similar to the 
following. 

1. The host may issue a Bus Status Inquiry to examine the status of commands 

executing on the bus. This is required to determine the actual command that has 
caused the error. The command that timed out may not be the command that is 
blocking the SCSI bus. The command that is most likely in error will be the one 
active on the bus when the Bus Status Inquiry is executed. 
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2. Normally, if a device is found to be connected on the SCSI bus indefinitely there 
is no way to clear the error without resetting the bus. When this is the case the 
Host should issue the Reset SCSI bus lOPB through the MCE. All work queues 
with commands active on the bus will have those commands returned with a SCSI 
reset error status and the work queue will be frozen (if the freeze work queue on 
reset option was selected in the Initialize Controller Command). The Host will 
then reissue the commands and unfreeze the work queues. The device which 
caused the error should either be removed or tested before restarting normal 
operation on other drives. 


3. 


For systems that have the ability to power a device down to avoid resetting the 
entire bus, the Host may issue a Flush Work Queue command to prevent new 
commands from being issued to the drive after the error has been cleared, but 
before the Host has properly restored the device. Flushing the queue is not 
required but the Jaguar will begin processing the commands from the queue after 
the bus becomes available and the command being executed is cleared. The Host 
may, after powering the device down, issue the Cancel Command Tag lOPB to 
clear the lOPB that was not completed by a normal SCSI completion or by a 
SCSI reset. The Flush Work Queue Command does not flush commands that are 
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completion, by a SCSI reset, or by issuing the Cancel Command Tag lOPB. 


Jaguar Software Interface Error Recoveiy Considerations 


Several areas of the software interface that affect Error Recovery have been modified. 
Controller initialization and Work Queue initialization commands have new fields to 
specify timeout values. The Freeze Work Queue operation may be optionally changed 
in the Initialize Controller Command to freeze a Work Queue that has an active 
command upon receiving a SCSI reset. (This is the recommended mode of operation. 
The default setting is provided for backward compatibility). Work Queue O’s length is 
normally one. Certain error recovery commands may always be issued through it 
however. The Controller Error Interrupt is used to report several command error 
conditions. 


lOPB TIMEOUT INITIALIZATION 

The lOPB timeout is specified in the initialize controller command for Work Queue 0, 
and in the initialize work queue command for all other queues. All lOPB’s issued 
through a work queue will use the timeout value specified for that work queue. 
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Work Queue Zero 

The ninth word of the Controller Initialization Block will be used for Work Queue 0 
command timeouts. This field (word 9) is specified in increments of approximately 
256mSecs. A value of 0 specifies no timeout. 

Work Queues 1-15 

The twelfth word of the Initialize Work Queue command contains the timeout value for 
commands issued through that work queue. Each work queue (device) will then be 
able to run a unique timeout value. This field is specified in increments of 
approximately 256mSecs. A value of 0 specifies no timeout. 

The Controller Initialization Block and Initialize Work Queue Command 
are reproduced here for clarity. 


WORD # 


0 

Nunnber of Conmand Queue Entries 

1 

DMA Burst Count 

2 

Controller Normal Completion Vector 

3 

Controller Error Completion Vector 

4 

Primary SCSI Bus ID 

5 

Secondary SCSI Bus ID 

6 

Command Response Block Offset 

7-8 

SCSI Selection Timeout 

9-OxA 

SCSI Work Queue Zero Command Timeout 

OxB-OxC 

VHE Bus Timeout 

OxO-OxE 

Reserved 

OxF 

Off Boar CRB Memory Type 

0x10-11 

Off Boarc CRB Address 

0x12 

Error Recc/ery Flags 


Update Figure 4. Controller Initialization Block 
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WORD # 


0 

Command (0x42) 

1 

Options 

2 

Return Status 

3 

Reserved 

4 

Normal Completion Vector 

Error Completion Vector 

5 

Interrupt Level 

0x6 



- 

RESERVED 


OxD 



E 

Work Queue Number 

F 

Work Queue Options 

10 

Nunber of Entries 

11 

Priority Level 

0x12-0x13 

IOPS Timeout 


Update Figure 5. Initialize Work Queue Command 


FREEZE WORK QUEUE ON SCSI RESET 

The Freeze Work queue operation may be enabled to freeze Work Queues when a SCSI 
reset occurs and that work queue had a command active on the SCSI bus. This allows 
the host to decide how to handle the SCSI reset before allowing commands to continue 
executing. The host will know a Work Queue is frozen if it receives a command 
returned from the queue with a SCSI bus reset error status. 

Work Queue Zero Length 

Work Queue Zero is defined to have a length of 1. This is done with the intention that 
only one error recovery process can occur at a time. However, it is possible that a 
command from Work Queue zero may require error recovery itself. To allow this to 
take place, certain commands may always be issued through Work Queue zero. SCSI 
Bus Reset and Flush Work Queue commands may always be issued through Work 
Queue zero. For all other commands Work Queue Zero will still have a length of one. 
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CONTROLLER ERROR INTERRUPT 

When a command timeout occurs the Jaguar must retain the lOPB until the error is 
cleared so that the command may be completed if the device responds before error 
recovery can take place. This also prevents new commands from being issued from the 
queue until the host can handle the error condition. To notify the host of a command 
timeout the Controller Error Interrupt will be used. 

CONTROLLER ERROR VECTOR 

The controller error vector is used for bit type commands. These are Start Queue 
Mode, Flush, and Flush and Report. It is also used for the following conditions: 

- lOPB type error 

- lOPB timeout 

- a device has connected for which no lOPB exists 

- a device is requesting more data to be transferred than the lOPB allows 

- a device is requesting a data transfer of the opposite direction specified by the 
direction bit of the lOPB. 

A bit (BIT 7) is set in the Command Response Status Word to indicate the response is 
due to one of the above conditions. 

The following status block is returned for the above errors. The bit commands do not 
return this information. This block is as follows: 


Word 

Even Byte 

Odd Byte 



DEC 

■^BK^BK^K^fluBK^I^^B^^fl 

7'6'5'4'3'2'l'o 
_1_1_1_1_1_1_1_ 

0 

Conmand Response Status Word 

1 

lOPB Type 

Reserved 

B 

Command Tag 

B 

Command Tag 


lOPB Length 

Work Queue Number 

B 

Reserved 

H 

Reserved 

Error Code 


Update Figure 6. Controller Interrupt Response Block 
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The defined error codes are as follows. 


Error Code 

Definition 

OxCO 

lOPB Type Error 

OxCl 

lOPB Timeout 


Update Figure 7. Generic MACSI Error Codes 


Error Code 

Definition 

0x82 

A target has reconnected for which no lOPB exists. 

0x83 

A target is requesting more data to be transferred 
than the lOPB transfer count allows. 

0x84 

A target is requesting a data transfer of the opposite 
direction specified in the direction bit of the lOPB. 


Update Figure 8. V/SCSI 4210 Specific Error Codes 


COMMANDS ADDED TO SUPPORT ERROR RECOVERY 

Three commands are provided specifically for error recovery. Two of the commands, 
Bus Status Inquiry and Command Status Inquiry, are provided tp find the status of 
commands on the board. The Cancel Command Tag lOPB is provided to remove an 
lOPB from the board. This command is provided for systems that can reset devices in 
error without resetting the SCSI bus. 

Command : Bus Status Inquiry 

Command Code : 0x45 

Function : 

This lOPB returns the Command Tag of any lOPB currently executing on the selected 
SCSI bus. In addition it will return Command Tags of any in progress lOPBS. An in- 
progress lOPB is one which has been sent to a drive but is not completed yet. This 
lOPB is used to find the command that is active on the bus at the time an lOPB 
timeout has occurred. This is important because a command may cause another 
command to timeout by blocking use of the SCSI bus by other devices. If a command 
other than the command that timed out is active on the bus, it will be nec^^sary to 
determine which command actually caused the error. A number of for 

determining the device in error may exist. One method would be to wait an additional 
period of time and check the board again to see that the state is the same as the 
previous check. This type of error is due either to incorrect programming or to a failed 
device and should be a rare occurrence. 
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During execution of this command, the board will stop all internal operations so that the 
response will reflect the state of the board at the time the Bus Status Inquiry lOPB is 
executed. 

This command must be issued to Work Queue 0. Information in the returned lOPB 
should be used to identify which lOPB and device has caused the error condition. 

This command can be issued to either the primary or the secondary Port by selecting the 
bus in the Unit Address field. 

WORD # 

0 
1 
2 

3 

4 

5 

6-OxE 
F 


Conmand (0x45) 


Options 


Return Status 


Reserved 


Normal Completion Vector 


Error Completion Vector 


Interrupt Level 


Reserved 


Reserved 


BUS Reserved 


BUS is located in Bit 3. 
BUS = 0 : Primary Bus 
BUS = 1 : Secondary Bus 

Returned Fields 


6-7 

8-OxF 


Active Command Tag 
Busy Commands Tags 


Update Figure 9. Bus Status Inquiry lOPB 


The ACTIVE COMMAND TAG field contains the COMMAND TAG of a Pass- 
Through lOPB if at that point in time the command is presently being executed on the 
bus. 

The BUSY COMMAND TAGS fields will contain any other currently "in-progress” 
lOPBS that may not be able to complete because they are in a disconnected state and 
being held off by the "hung" ACTIVE COMMAND. There could potentially be 7 
BUSY COMMANDS per port. ( WORDS 8,9 A,B C,D E,F 10,11 12,13 14,15 ) 

Command : Command Status Inquiry 

Command Code : 0x46 

Function : 






18 V/SCSI 4210 UPDATE 


This lOPB returns the state of a previously issued lOPB based on the command tag 
field. If the lOPB specified by the command tag is active on the bus information will be 
returned to help indentify the state of the SCSI activity. The Command Status Inquiry 
lOPB must be issued to Work Queue 0. The Jaguar will suspend hardware operations 
until the status of the command is found and posted. 

WORD # 



Returned Information: 

12 
13 
U 
15 

Update Figure 10. Command Status Inquiry lOPB 
Returned Information is posted in these fields. 

A. Command State Field ( CSF ) 

0x01 Command not found (Command Tag did not match ) 

0x02 Command in Work Queue (Not executing yet ) 

0x03 Command Currently Active (Currently on SCSI Bus ) 

0x04 Command Busy (Currently Disconnected ) 

0x05 Command on Done Queue (The command is on the internal done queue 

and will have been received by the host before 
the response to the Bus Inquiry ) 

0x06 Command in Command Queue (Still in Short I/O ) 

Oxnn Other States (May include VME bus status ) 

B. Active Command Additional Information Fields 

K the Command inquired about is Currently Active (0x03), the state of the 
controller and the SCSI bus is also reported back in two additional fields. 
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1. ( LCMD “ last command ) 

Last Command Issued to the Jaguar’s SCSI Controller (Fujitsu 87030) 

0x00 Bus Release 

0x01 Select Device 

0x02 Reset Attention 

0x03 Set Attention 

0x04 Transfer Data 

0x05 Transfer Data Pause 

0x06 Reset SCSI Handshake Line 

0x07 Set SCSI Handshake line 

2. ( PSNS -- phase sense ) 

Current SCSI Bus Status 

Bits 7 - 0 Hold the state of the SCSI Bus Signals the SCSI bus the command is active 
on. ( 1 = active ) 

7 - Request 
6 - Acimowledge 
5 - Attention 
4 - Select 
3 - Busy 
2 - Message 
1 - Command / Data 
0 - Input / Output 

Command : Cancel Command Tag 

Command Code : 0x48 

Function : 

This lOPB cancels the execution of a previously issued lOPB based on the command tag 
field. This command must be issued to Work Queue 0. If an lOPB is cancelled and 
subsequent SCSI activity attempts to complete the command the Jaguar will return a 
controller error with the information that a device has connected for which there is no 
lOPB. 

If the Jaguar does not have a command with a command tag that matches the Jaguar 
will return the Cancel Command Tag lOPB with an error. 

Use of this command implies that the host use unique command tags for all lOPB’s 
residing on the board. Tlie Jaguar will find the first command tag that matches the one 
given in the lOPB and cancel that one. If multiple lOPB’s exist with the same 
command tag, only the first one found will be canceled. 
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WORD # 
0 
1 
2 

3 

4 

5 

6-OxF 

10-11 

12-15 


Coninand (0x48) 


Options 


Return Status 


Reserved 


Nornial Completion Vector Error Completion Vector 


Interrupt Level 


Reserved 


Command Tag 


Reserved 


Update Figure 11. Cancel Command Tag lOPB 


JAGUAR CONTROLLER SPECIFIC SPACE 


Several registers in the Controller Specific Space provide information that is useful for 
determining the status of the SCSI bus during error conditions. 

Address offset 0x7AC contains two bytes that describe the last device ID connected on 
both the primary and secondary ports. The Bits 8-15 contain the Primary Bus ID last 
connected. The Bits 0-7 contain the Secondary bus last connected. 

Address offset 0x7AE contains two bytes that describe the SCSI status. These bytes are 
only updated approximately every 32msec. They are only useful in general for 
determining SCSI bus error conditions. Bits 8-15 contain the Primary bus status. Bits 
0-7 contain the Secondary bus status. 


The bus status byte for each bus is an image of the Fujitsu 87030 phase sense register. 
The format of that register is as follows. 


Primary 


Secondary 


Request (REQ)^ 
Acknowledge (ACK) —> 
Attention (ATM) 
Selection (SEL) 

Busy (BSY) 

Message In/Out (MSG) 
Command (C/D) 

Data In/CXit (I/O) 



L Data In/Out (I/O) 
Command (C/D) 
Message In/Out (MSG) 
Busy (BSY) 
Selection (SEL) 
Attention (ATM) 
Acknowledge (ACK) 
Request (REQ) 


Update Figure 12. Phase Sense Register Offset 0x7AE 
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Each of these signals are active high. They each correspond to a signal on the SCSI 
bus. For a complete description of each signal see the SCSI spec or the 87030 users 
guide. 

The signals of most importance are BSY and SEU When BSY is a 1 the Jaguar is 
connected to the SCSI bus. When SEL is a ’T it indicates that someone on the bus is 
attempting to select or reselect another device. These signals are updated every 27 to 
35 milli-seconds. If the host is attempting to use this register to determine if the bus is 
hung it should allow at least twice that period before making a decision. The actual 
amount of time required is dependent on the system. In general it should be longer 
than the longest data transfer that might occur in the system. 

FROZEN WORK QUEUES REGISTER 

This register will have a one set for any work queue that is frozen. The Jaguar supports 
15 work queues (0 through 14). For queues 1 to 14 if the queue is currently frozen the 
corresponding bit position is set in this long word. For instance, if Work Queue 1 is 
frozen the Freeze Status will equal 0x00000002. Work Queue 0 cannot be frozen. 
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The following is a ''C language structure that describes the Controller Specific Space. 

/'******•*•**■*•■*■***** Configuration Status Block (CSB) ■*■******■*■*/ 


t 3 rpedef struct csb { 
UWORD csb_RES0; 

UBYTE csb_RESl; 

char csb_PCODE[3]; 

UWORD csb_RES2; 

UBYTE csb_RES3; 

char c sb_PVAR; 

UWORD csb_RES4; 

UBYTE csb_RES5; 

char csb_FREV[3]; 

UWORD csb_RES6; 

char csb_FDATE[8]; 

UWORD csb_RES7; 

UWORD csb_BSIZE; 

UWORD csb_RES8[2]; 

UBYTE csb_PID; 

UBYTE csb_SID; 


/* Configuration Status Block 120 

bytes*/ 

/* Reserved word 

*/ 

/* Reserved byte 

*/ 

/* Product Code 

*/ 

/■*■ Reserved word 


/* Reserved byte 

*/ 

/* Product Variation 

*/ 

/* Reserved word 


/* Reserved byte 


/* Firmware Revision level 

*/ 

/* Reserved word 

x/ 

/* Firmware Release date 

V 

/* Reserved word 

*/ 

/* Buffer size in Kbytes 


/* Reserved word 


/* Primary Bus ID 

*/ 

/* Secondary Bus ID 

V 


UBYTE 
UBYTE 
UBYTE 
UBYTE 
UBYTE 
UBYTE 
UBYTE 
UBYTE 
ULONG 
} VJ_CSB; 




csb_SEC_SLCTD;/* 
csb_PRI_PSNS; /* 
csb_SEC_PSNS; /* 
csb_RSRVD9; /* 
csb_DB_ID; /* 
csb_RSRVD10; /* 
csb_DIP_SW; /* 
csb_FRZ_BITS /* 


•A* / 
'V 


Secondary Port Last Device Selected */ 
Primary Port Phase Sense Shadow */ 
Secondary Port Phase Sense Shadow */ 
Reserved byte */ 
Daughter Board ID */ 
Reserved byte */ 
Software Dip Switch Setting */ 
Queue Frozen Statuses */ 


ADDITIONAL ERT INFORMATION 


1. ERT Command Issuance Rules 

Ail ERT commands must be issued through the MCE to Work Queue 0. They 
may be issued at any time. 


2. Controller Error Clarification 

Controller Errors are generated for unusual situations that may occur on the 
board but are not related to a specific lOPB. They may also be generated due to 
the fact that an lOPB may not have the proper information required to be 
processed normally, or some unusual intermediate conditions exist. The returned 
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structure in the CRB does not contain an lOPB. Instead the Command 
Response block contains an error code indicating what has happeneu and CQE 
information (command tag, iopb length, work queue number) if it is valid. 

For these defined errors a bit is defined in the CRSW called the Status Change 
bit ( SC = = bit 7 ). This bit will be set along with the ER bit to indicate these 
errors. The CRSW will read 0x0085. (SC,ER,CRBV bits are set) 

Controller Errors will not generate an interrupt if the controller error interrupt 
level is set to 0 in the Initialize Controller IOPB. The board will still return the 
status in the Command Response Block and will set the CRBV bit in the 
Command Response Status Word. 


DEFINED CONTROLLER ERRORS — ( elaboration of the ERT spec. ) 

A. IOPB Type Error -- 

If the IOPB type field is invalid the overall structure of the IOPB is not 
known and therefore continued processing on it can not be executed. 

Error Code OxCO CQE information -- invalid. 

B. IOPB Time-Out Error - 

An lOPB’s timer has completed and the controller is notifying the host of 
the condition. The IOPB will remain active until it completes properly or 
is cancelled explicitly. The status of the IOPB may be inquired about with 
the Command Status Inquiry IOPB. 

Error Code OxCl CQE information -- valid. 

C. Unknown Device Reconnection 

A SCSI device has re-selected the Jaguar for which no current IOPB exists. 
Error Code 0x82 CQE information ~ invalid. 

D. Data Transfer Count Mismatch 

Data Counters have been exhausted but the device is reoi^esting more data 
than the current IOPB can transfer. 

Error Code 0x83 CQE information - valid. 




24 V/SCSI 4210 UPDATE 


E. Data Direction Errors 

The direction bit in the lOPB does not match the data transfer direction 
requested on the SCSI bus. 

Error Code 0x84 CQE information ~ valid. 


3. Command Time-Out Situations 

Command time-outs invoke the controller error response (B) from above. If the 
command subsequently completes correctly, the original lOPB will complete 
properly. The host may attempt to cancel the lOPB with the Cancel Command 
Tag lOPB. This will cause the Jaguar to terminate any further execution. The 
cancelled lOPB will not be posted back to the host. If the lOPB is active on the 
SCSI bus, the command caimot be cancelled and the host must either reset the 
SCSI bus or remove the device from the bus in some external manner. The 
command will then be posted with a canceled due to bus reset status or invalid 
sequence error if it abruptly disconnects from the bus. 


JAGUAR PRINTER PORT DESCRIPTION 

INTRODUCTION 


The Printer Port allows a system to transfer data to either a Centronics or Data 
Products interface printer. A version is also available to use with a Data Products long- 
line interface. The printer port is a daughter card that attaches to the V/SCSI 4210 
Jaguar. The Printer Port is commanded in much the same fashion as a SCSI device. 
Printer Port control has been integrated into the Jaguar/MACSI interface, therefore the 
user should be f amili ar with the Jaguar manual. The Jaguar will DMA the printer data 
from Host memory, transfer the data to the printer, and return a completion status. 
Printer status may be monitored asynchronously at any time by the host. The host may 
also request that the Jaguar interrupt the Host when a status change occurs. The 
printer port does not affect the normal operation of the primary SCSI channel. 
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HOW TO USE THE PRINTER PORT; 


PRINTER PORT CONFIGURATION JUMPER INSTALLATION: 

The user must ensure that the Printer Port is physically configured for the type of 
printer being used. When the jumper at JAl is installed, the Printer Port is configured 
to interface with a Centronics printer. When this jumper is removed, the Printer Port is 
configured to interface with a Data Products printer. The jumper configuration can be 
determined by software from the Printer Status byte. The Data Products long line 
interface version has no jumper and appears to the system software as a standard board 
configured for a Data Products interface. 


INITIALIZATION: 


After the Host has performed the usual Jaguar initialization procedures, the Daughter¬ 
board ID may be verified in Controller Specific Space to ensure the Printer Port is 
installed. The Printer Port ID is 0x04 and is located at the board base address plus an 
offset of 0x7Bl. A separate work queue for the Printer Port must be initialized using 
the Initialize Work Queue command. The work queue initialization is the same as for a 
SCSI device. The work queue must be used exclusively used for the printer port. 

The first command to the printer work queue should be the Initialize Printer Port 
command. This command sets the polarity of parity for Data Products printers and 
specifies which printer status lines may generate a status change interrupt. 

The Initialize Printer Port command can be issued at any time to reset the Printer Port. 
The command is issued with the reset bit set to clear the printer port hardware. It 
should never be necessary to reset the hardware. 

The Initialize Printer Port command may also be ssued at any time to assert a buffer 
clear to the printer. Since the time required for holding this signal varies fi'om printer 
to printer the Jaguar will leave the line set until the host issues another Initialize Printer 
Port command with the bit cleared. 

NOTE: The work queue initialized for the printer must be used exclusively for the 

Printer Port. This is consistent with work queue usage for SCSI devices. 
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PRINTER COMMANDS: 


The Printer Port can now receive Printer Port Commands. The Jaguar will queue 
printer commands as received and work on each command in a FIFO manner as the 
previous command completes. When a the GO bit for a printer command is set the 
command will be copied from Short I/O space into the internal Printer Port work 
queue. After the lOPB has been parsed for correctness the data will be simultaneously 
DMA’d from system memory and transferred to the printer. The Maximum Transfer 
Length field is used to specify the length of the VMEbus transfer. Since the Jaguar can 
not transfer odd byte length data across the VME bus a second field specifies the actual 
amount of data to transfer to the printer. The VME transfer length must be rounded up 
to the nearest word (16 bit) or long word (32 bit) boundary. The Printer Transfer 
Length field specifies the exact number of bytes to be transferred to printer. When all 
the data has been transferred to the printer, a copy of the lOPB modified with the 
current printer status and return code will be placed in the CRB. 


If the printer port is configured for the Data Products interface the Host may want to 
send special font or control characters to the printer using the Paper Instruction control 
line of the Data Products interface. The Jaguar supports this with the Paper Instruction 


up 
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transfer all of the data specified in this lOPB to the printer with the Paper Instruction 
interface signal active. Paper Instruction is only supported by Data Products printers. 


NOTE: The Maximum Transfer Length field cannot contain an odd number of 

bytes. It must be rounded up to the nearest word or long word boundary 
depending on the transfer size specified. 


EXAMPLE PRINTER PORT OPERATION 


Initialize Controller lOPB 
Initialize Work Queue lOPB (s) 
Initialize Work Queue lOPB (s) 
Printer Port lOPB (s) 


*■ 



Command Complete 
Command (s) Complete 
Command Complete 
Command (s) Complete 
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STATUS REPORTING: 

The printer status may be accessed in three ways from the Jaguar. 

First, the state of the status lines will be updated periodically in Controller Specific 
Space for asynchronous monitoring by the Host. This status byte is located at the board 
base address plus an offset of 0x7AF. This byte is updated whenever On-line, Ready, 
Parity Error, Cable On changes state for a Data Products interface. It is updated 
anytime Select, Fault, or Paper Empty changes state for a Centronics interface. 
Otherwise it is updated at the completion of a print command and roughly every 
30Msec. The second method is for the Jaguar to use the Controller Interrupt Vector 
specified in the Initialize Controller lOPB. The Host may select which status lines can 
generate an interrupt in the Initialize Printer Port lOPB. An interrupt is generated 
when an enabled status line (except parity) toggles either active or inactive. Parity error 
is only reported when it becomes active. 

The complete status word will be updated in Controller Specific Space and a Command 
Response Block will be posted. 

The third method is initiated by the Host issuing a Printer Port lOPB with both the 
Maximum Transfer Length and the Printer Transfer Length fields set to zero. This will 
cause the Printer Port to update the Printer Status field of the lOPB and immediately 
return it as command completed. 
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DETAILED COMMAND AND STATUS REPORTING STRUCTURE DESrRTPTTONS! 
INITIALIZE PRINTER PORT lOPB: 

The Initialize Printer Port lOPB is used to configure the printer port for the interface 
being used and to enable/disable status change interrupts. A Status Change Interrupt 
vector must be supplied in the Initialize Controller command to allow status change 
interrupts. This lOPB can also be issued at any time to reset the Printer Port or to 
issue a buffer clear to the printer. 


WORD # 
0 
1 
2 

3 

4 

5 

6-QxD 

OxE 

OxF-15 


Ccxnmand (0x4A) 


Options 


Return Status 


Reserved 


Normal Completion Vector Error Completion Vector 


Interrupt Level 


Reserved 


RST 0/E B/C Reserved Status Change Int. Enable 


Reserved 


Update Figure 13. Initialize Printer Port lOPB 


Options: 

Bit 1-15 - Reserved - 0 
Bit 0 - Interrupt Enable 

Return Status: 

0 = Normal execution 

All existing generic error codes. 

Reset (RST); 

The Initialize Printer Port command can be issued at any time to reset the Printer Port. 
The Jaguar will reset the printer hardware and will be ready to receive new print 
commands after the completion status has been returned to the host. 


1 = Reset Printer Port 
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Odd/Even (O/E): (Data Products printers ONLY) 

This bit specifies the parity polarity. 

0 = Even Parity 
1 = Odd Parity 

Buffer Clear (BC); 

(Data Products - Buffer Clear) 

(Centronics - Printer Init) 

The Initialize Printer Port command can be issued at any time to assert a buffer dear to 
the printer. The Host must issue another Initialize Printer Port command with the buffer 
clear bit set to 0 to clear the condition. 


0 = Buffer Clear/Printer Init inactive 
1 = Buffer Clear/Printer Init active 


Status Change Interrupt Enable Definitions (active high): 


Data Products Printers: 

Bit 7 - Reserved - 0 
Bit 6 - Reserved - 0 
Bit 5 - Reserved - 0 
Bit 4 - Reserved - 0 
Bit 3 - Cable On 
Bit 2 - Parity Error 
Bit 1 - Online 
Bit 0 - Ready 

PRINTER PORT lOPB 


Centronics Printers: 

Bit 7 - Reserved - 0 
Bit 6 - Reserved - 0 
Bit 5 - Reserved - 0 
Bit 4 - Reserved - 0 
Bit 3 - Reserved - 0 
Bit 2 - Paper Empty 
Bit 1 - Select 
Bit 0 - Fault 


The Printer Port lOPB is a modified version of the Generic lOPB format described in 
the Jaguar manual. A new command code of 0x23 is defined and a new transfer length 
field has been created. All fields not specified below will be the same as the Generic 
lOPB. 
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UORD # 


0 

Cocnmand (0x23) 

1 

Options 

2 


Return 

Status 

3 

Reserved 

4 

Normal Completion Vector 

Error Completion Vector 

5 

Interrupt Level 

6 

Reserved 

_ 

7 

Trans. Type 

Memory Type 

Address Modifier 

8 

9 

Address Buffer 

A 

B 

! 

Maximum Transfer Length 1 

C 

D 

Printer Transfer Length 

E 

Reserved 

Printer Status 

OxF-15 

i 

Reserved 


Update Figure 14. Printer Port lOPB 


Options: 

Bit 9-15 - Reserved - 0 
Bit 8 - Paper Instruction 
Bit 7 -1 - Reserved - 0 
Bit 0 - Interrupt Enable 

When the Paper Instruction option is set to 1, the Jaguar will transfer all of the data 
specified in this lOPB to the printer with the Paper Instruction interface signal active. 
Paper Instruction is only supported by Data Products printers. 
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Return Status: 

All existing generic error codes and: 

0x91 Maximum Transfer Length must be greater than or equal to the Printer Transfer 
Length. 

0x92 Maximum Transfer Length was set to zero, but Printer Transfer Length was not 
zero. 

0x93 Printer Port not present or not initialized. 

0x99 Scatter Gather not supported for this device. 

Memoiy Type: 

Long word (32 bit) and (16 bit) word transfers will be supported. 

Maximum Transfer Length and Printer Data Transfer Length Fields: 

The Printer Transfer Length field is used in conjunction with the Maximum Transfer 
Length Field to handle odd-byte transfer operation. 

Printer Transfer Length field: 

The Printer Transfer Length field must contain the exact count of bytes to be sent to the 
printer and must be filled in on each lOPB. 

Maximum Transfer Length field: 

The 4210 must perform either word (16 bit) or long word (32 bit) transfers across the 
VMEbus. To handle odd byte transfers the Maximum Transfer Length field must be 
rounded up to pad the transfer out to a word or long word boimdary. 

Requesting status: 

A length of zero in the Maximum Transfer Length field and in the Printer Data transfer 
Length Field will cause the Jaguar to return the lOPB with the current printer status. 
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PRINTER STATUS: 


Data Products Status Definition (Active High): 

Bit 7 - Software Readable Jumper 1 = Data Products, 0 = Centronics 

Bit 6 - Paper Movement 

Bit 5 - Top of Form 

Bit 4 - Bottom of Form 

Bit 3 - Cable On 

Bit 2 - Parity Error 

Bit 1 - Online 

Bit 0 - Ready 


Centronics Status Definition (Active High): 


Bit 7 - 
Bit 6 - 
Bits - 
Bit4- 

TD-+ ”2 
JJit ^ - 

Bit 2 - 
Bit 1 - 
BitO- 


Software Readable Jumper 1 = Data Products, 0 
Busy 

Reserved - value returned may be either 0 or 1 
Reserved - value returned may be either 0 or 1 

XX^d^lV^Vl * VOrlU^ Vf JL 

Paper Empty 

Select 

Fault 


= Centronics 


COMMAND RESPONSE BLOCK DEFINITION 

If status change interrupts have been enabled the following Command Response Block 
will be posted and the Host is interrupted when a status change occurs. The Status 
Change bit in the Command Response Status Word is set and an image of the printer’s 
status lines is returned. More than one status line may change in a single interrupt so 
the entire status should be verified by the Host. 


Word 

DEC 

Even Byte 

Odd Byte 

15 

'l4 'l3 ‘l2 ‘l1 ‘lO ' 9 ' 8 

j_1_1_1_1_1_1_ 

7‘6'5'4'3'2‘l'o 

_1_1_1_1_1_1_1_ 

0 

Cotnmand Response Status Word 

1 


Reserved 

5 




6 

Reserved 

Error Code 


Update Figure 15. Command Response Status Word 
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Command Response Status Word: 

All existing CRSW bits and: 

Bit 7 - Status Change 
Printer Status: 

Same as defined in the Printer Port lOPB (Data Products Status Definition (Active 
High) and Centronics Status Definition (Active High). 

Return Code: 

0x90 - Printer Status Change Interrupt 
CONNECTOR 


The printer interface is available on connector P4 only. The pinout allows for a flat 
ribbon cable to be used to connect to a Data Products printer. A Centronics printer will 
require a cable that connects the correct pins from the boards 50 pin connecter to the 
printer’s 36 pin connector. The following tables describe the pinouts for the Data 
Products and Centronics printers. 


Update Table 2. Data Products Short Line Interface (P99) 


4210 P4 

Data Products 

Functions 

4210 P4 

Data Products 

Function 

6 

19 

DATA 1 

11 

37 

RETURN 

7 

3 

RETURN 

42 

31 

BUFFER CLEAR 

9 

20 

DATA 2 

43 

15 

RETURN 

10 

4 

RETURN 

34 

12 

+5V (NOT SUPPLIED) 

1 

1 

DATA 3 

15 

22 

READY 

4 

2 

RETURN 

16 

6 

RETURN 

23 

41 

DATA 4 

12 

21 

ON LINE 

20 

40 

RETURN 

13 

5 

RETURN 

2 

34 

DATA 5 

18 

23 

DEMAND 

3 

18 

RETURN 

19 

7 

RETURN 

29 

43 

DATA 6 

30 

27 

PARITY ERROR 

26 

42 

RETURN 

31 

11 

RETURN 

8 

36 

DATA 7 

24 

25 

BOTTOM OF FORM 

5 

35 

RETURN 

25 

9 

RETURN 

33 

28 

DATA 8 

27 

26 

PAPER MOVING 

32 

44 

RETURN 

28 

10 

RETURN 

36 

29 

DATA PARITY 

17 

39 

GROUND 

37 

13 

RETURN 

21 

24 

TOP OF FORM 

39 

30 

PAPER INSTRUCTION 

22 

8 

RETURN 

40 

14 

RETURN 

38 

46 

INTERFACE CONNECTED 

14 

38 

DATA STROBE 

35 

45 

INTERNS/:" '■'^NNECTE"? e'^TURN 





«^0'0'>joruoj 0"0 ow o 
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Update Table 3. Centronics Interface (P99) 


4210 P4 

Centronics 

Function 

4210 P4 

Centronics 

Function 

6 

2 

DATA 1 

11 

19 

RETURN 

7 

20 

RETURN 


31 

PRINTER INITIALIZE 

9 

3 

DATA 2 


30 

RETURN 

10 

21 

RETURN 


NU 

NOT USED 

1 

4 

DATA 3 

15 

32 

FAULT 

4 

22 

RETURN 

16 

NU 

NOT USED 

23 

5 

DATA 4 

12 

13 

SELECT 1 

20 

23 

RETURN 

13 

NU 

NOT USED 

2 

6 

DATA 5 

18 

10 

ACKNOWLEDGE 

3 

24 

RETURN 

19 

28 

RETURN 

29 

7 

DATA 6 

30 

12 

PAPER ENTRY 

26 

25 

RETURN 

31 

NU 

NOT USED 

8 

8 

DATA 7 

24 

NU 

NOT USED 

5 

26 

RETURN 

25 

NU 

NOT USED 

33 

9 

DATA 8 

27 

11 

BUSY 

32 

27 

RETURN 

28 

29 

RETURN 

36 

NU 

NOT USED 

17 

NU 

NOT USED 

37 

NU 

NOT USED 

21 

NU 

NOT USED 

39 

NU 

NOT USED 

22 

NU 

NOT USED 

40 

NU 

NOT USED 

38 

NU 

NOT USED 

14 

1 

DATA STROBE 

35 

NU 

NOT USED 


Update Table 4. Data Products Long Line Interface (rlOo) 


Data Products 

Functions 

4210 P4 

Data Products 

Function 

19 

DATA 1+ 

11 

37 

DATA STROBE- 

3 

DATA 1- 

42 

31 

BUFFER CLEAR-*- 

20 

DATA 2+ 

43 

15 

BUFFER CLEAR- 

4 

DATA 2- 

34 

12 

-t-5V (NOT SUPPLIED) 

1 

DATA 3+ 

15 

22 

READY-^ 

2 

DATA 3- 

16 

6 

READY- 

41 

DATA 4+ 

12 

21 

ON LINE-*- 

40 

DATA 4- 

13 

5 

ON LINE- 

34 

DATA 5+ 

18 

23 

DEMAND-*- 

18 

DATA 5- 

19 

7 

DEMAND- 

43 

DATA 6+ 

30 

27 

PARITY ERROR-*- 

42 

DATA 6- 

31 


PARITY ERROR- 

36 

DATA 7+ 

24 


BOTTOM OF FORM-*- 

35 

DATA 7- 

25 


BOTTOM OF FORM- 

28 

DATA 8+ 

27 


PAPER NOVI NO*- 

44 

DATA 8- 

28 


PAPER MOVING- 

29 

DATA PARITY+ 

17 


GROUND 

13 

DATA PARITY- 

21 


TOP OF FORM-*- 

30 

PAPER INSTRUCTI0N+ 

22 


TOP OF FORM- 

14 

PAPER INSTRUCTION- 

38 


INTERFACE CONNECTED 

38 

DATA STROBE+ 

35 

Hi 

INTERFACE CONNECTED RETURN 

_ 
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DEFICIENCIES 


The following lists cite KNOWN deficiencies, potential improvements and the 
most current fixes and improvements within the XOU firmware described in 
the V/SCSI 4210 Jaguar User’s Guide, Rev # XOF. 

• Linked Commands are not supported. 

• Multiple LogicaTUnits on the same SCSI device are not supported. 

• Extended Diagnostics command is not implemented. 


POTENTIAL IMPROVEMENTS 


Potential improvements are recommended additions/enhancements to the XAD 
firmware product not specifically described in the User’s Guide, Rev # XOF. These may 
or may not be implemented in future releases of the firmware. 

• Target mode operation of the SCSI port. 


FIXES AND IMPROVEMENTS 

This is a summary of bugs corrected and improvements added to date. 

• High priority command operation. 

• Synchronous offset operation. 

• Board lock-up on write commands that cause an internal buffer wrap condition 
but do not transfer any data (i.e., terminate in a check condition status). 

• Commands that take a long time to return data resulted in a false Bus Error 
(0x20) status return for the command. 

• Lock-up when an invalid address was intentionally requested. This error is 
dependent on SCSI device speed. 

• Secondary port odd byte transfer operation. 

• Scatter/gather limited to total transfer lengths equal to the total buffer space 
divided by the number of work queues. Otherwise, error is returned. 

• XOP firmware did not allow group 1 and 5 commands. 
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• By-pass SCSI bus reset on power up. 

• Parity errors on message transfers. 

• Daughter card support. 

• VME/SCSI transfer count mismatches. 

• External SCSI Reset operation. 

• 2 byte window problem on Fujitsu 87030. 

• Freeze/thaw work queue operation. 
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V/SCSI 4210 BOARD SPECIFICATIONS 

The following table cites design parameters specific to the V/SCSI 4210 board. 

VMEbus SPECIFICATIONS 


DTB Master 

A24, A32, D16, D32 

DTB Slave 

A16, D8, D16 

Requester 

Any of R(0-3), Static 

Interrupter 

Any of 1(1-7), Dynamic 

SCSI bus SPECIFICATION 


Peripheral Data Rate 

Up to 4Mbytes/sec synchronous 

Tin tn 1 SMhvtes/sp^r asvnrhrnnnn*; 

OPERATING ENVIRONMENT 


Temperature 

0-55 degrees Centigrade 

Relative Humidity 

10% - 90% Noncondensing 

POWER REQUIREMENT (Single-ended drivers) 

V/SCSI 4210 Jaguar 

4.67 A typical @ +5VDC ( + /- 5%) 

6.85 A maximum @ +5VDC ( + /- 5%) 

V/SCSI 4210-DC Option SCSI port 

0.75 A typical @ +5VDC ( + /- 5%) 

1.25 A maximum @ +5VDC ( + /- 5%) 

MECHANICAL (nominal) 


Length 

233 mm 

Width 

160 mm 

Thickness 

20 mm 

Weight 

.45 Kg 

RELIABILITY 


MTBF per MIL STD 217E 

68,400 hours 
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ERRATA CORRECTIONS 


Page 10 . Replace the following text: 

Bit 0 Start Queue Mode (SQM); 

The Jaguar will acknowledge entering Queued lOPB mode by issuing a Command 
Complete Interrupt with the Queue Mode Started bit in the Command Response Status 
Word set to ’1’ (see Command Response Status Word). The interrupt will use the 
Controller Interrupt Vectors, which should also be initialized before setting Start Queue 
Mode (See Initialize Controller Command). 

WITH 

Bit 0 Start Queue Mode (SQM): 

The Jaguar will acknowledge entering Queued lOPB mode by setting the Queue Mode 
Started bit in the Command Response Status Word set to ’T (see Command Response 
Status Word). No interrupt will be generated. 

Page 11 . ‘Bit 2: Flush Queue and Report’ 

The description of the Flush Queue and Report bit incorrectly states that the Jaguar will 
reset the SCSI bus if a command has been issued to a device. The host may reset the 
SCSI bus by issuing the Reset SCSI Bus lOPB. 

Page 24 . Replace the following text: 

Bit 5 Queue Mode Started (QMS); 

The Jaguar acknowledges entering Queued lOPB mode by issuing a Command 
Complete Interrupt with the QMS bit set in the Command Response Status Word. The 
interrupt will use the Controller Interrupt Vectors, which should also be initialized 
before setting Start Queue Mode. (See Initialize Controller Command). 

WITH 

Bit 5 Queue Mode Started (QMS); 

The Jaguar will acknowledge entering Queued lOPB mode by setting the Queue Mode 
Started bit in the Command Response Status Word set to ’1’ (see Command Response 
Status Word). No interrupt will be generated. 
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Page 59 . Add the following text after the heading: 

Controller Normal Completion Vector (2 bytes): 

The Controller Vector is used by the Jaguar when reporting the completion of the 
following commands: Flush All Queues and Report, and Flush All Queues. The 
Controller Vector is also used for support of the Error Recovery tools. See the 
appendix on Error Recovery Tools for more information. 

Page 59 . Replace the following text 

Bits 0-7 Interrupt Vector (IV): 

These bits set the Interrupt Vector used by the Jaguar when reporting the normal 
completion of any Initialize Controller Command. 

Bits 8-10 InterruDt Level CIL): 

A ■*> ' 

These bits set the Interrupt Level used by the Jaguar when reporting the normal 
completion of any Initialize Controller command. 

WITH 

Bits 0-7 Interrupt Vector (IV): 

These bits set the Interrupt Vector used by the Jaguar when reporting normal controller 
interrupts. 

Bits 8-10 Interrupt Level (IL): 

These bits are the Interrupt Level used by the Jaguar when reporting normal controller 
interrupts. 

Page 60 . Replace the following text: 

Controller Error Completion Vector (2 bytes): 

The Controller Error Vector is used by the Jaguar when reporting the error completion 
of the following commands: Start (^eue Mode, Flush All Queues and Report, and 
Flush All Queues. 

Bits 0-7 Interrupt Vector (IV): 

These bits set the Interrupt Vector used by the Jaguar when reporting the error 
completion of any Initialize Controller Command. The host sets this byte and it is not 
modified by the Jaguar. 
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Bits 8-10 Interrupt Level (IL): 

These bits set the Interrupt Level used by the Jaguar when reporting the error 
completion of any Initialize Controller command. The host sets these bits and the 
Jaguar does not modify them. 

WITH 

Controller Error Completion Vector (2 bytes); 

The Controller Error Vector is used by the Jaguar when reporting the error completion 
of the following commands: Flush All Queues and Report, and Flush All Queues. The 
Controller Error Vector is also used for conditions related to the Error Recovery Tools. 
See the appendix on Error Recovery tools for that information. 

Bits 0-7 Interrupt Vector (IV): 

This byte is the Interrupt Vector used by the Jaguar when reporting Controller Error 
Interrupts. 

Bits 8-10 Interrupt Level (IL): 

These bits set the Interrupt Level used by the Jaguar when reporting the Controller 
Error Interrupts. 

Pa ge 71 . ‘Flush Work Queue Command’ 

The Reset SCSI Bus on Command In Progress (RIP) bit will not be implemented. The 
host may reset the SCSI bus by issuing the Reset SCSI Bus lOPB. 

Pa ge 97 . ‘Figure D5 Total Transfer Count’ 

The correct offset for the location of the total scatter/gather transfer count is word OxOC 
and word OxOD of the lOPB. The manual incorrectly specifies words OxOA and OxOB. 
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